Jump to main content

##

# TCPIP_TFTPS_HandlerRegister Function

## C

    TCPIP_TFTPS_HANDLE TCPIP_TFTPS_HandlerRegister(TCPIP_NET_HANDLE hNet, TCPIP_TFTPS_EVENT_HANDLER handler, const void* hParam);

## Returns

- Returns a valid handle if the call succeeds
- Returns null handle if the call failed (out of memory, for example)

## Description

This function registers a TFTP Server event handler. The TFTP Server module will call the registered handler when a TFTP Server event (TCPIP_TFTPS_EVENT_TYPE) occurs during the File transfer process.

## Remarks

The handler has to be short and fast. It is meant for setting an event flag, not for lengthy processing!

## Preconditions

The TFTP Server module must be initialized.

## Parameters

Parameters | Description
--- | ---
hNet | Interface handle. Use hNet == 0 to register on all interfaces available.
handler | Handler to be called when a DNS client event occurs.
hParam | Pointer to non-volatile ASCIIZ string to be used in the handler call. It is used as a domain/host name. If not NULL, a TFTP Server module notification will be delivered only for a file name resolution that matches the hParam. If the hParam == 0, then the notification is triggered for any host name resolution.