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. |