HSE_REQ_IO_COMPLETION

Using this support function, you can set a special callback function that will be used for handling asynchronous I/O operations.

BOOL ServerSupportFunction(

  HCONN ConnID,  

  DWORD HSE_REQ_IO_COMPLETION, 

  PFN_HSE_IO_COMPLETION pfnIOCompletion,  

  LPDWORD lpdwSize,  

  LPDWORD lpdwContext

);

Parameters

ConnID

Specifies the connection identifier of the client to which the response data should be sent.

pfnIOCompletion

Points to the function, of type PFN_HSE_IO_COMPLETION, that will be called when the pending I/O operation has completed.

lpdwSizeofBuffer

Unused in this ServerSupportFunction request type.

lpdwContext

Points to an application-defined context structure. This pointer will be passed as a parameter when the callback function is invoked, after the pending I/O operation has completed.

Remarks

Note that this support function does not actually perform any asynchronous I/O operations itself.

If the callback function is set to NULL, the callback function will never be called by IIS. If this support function is called multiple times, only the callback function specified by the last function call will be honored by IIS. All previous callback function settings will be lost.

If there is an error performing an asynchronous I/O operation, IIS will make exactly one call to the callback function that is specified by pfnIOCompletion in this support function. It is then your ISAPI extension's responsibility to do the necessary cleanup of any allocated resources associated with that operation.

See Also

Asynchronous I/O Processing

HSE_REQ_ASYNC_READ_CLIENT