WS_OPEN_LISTENER_CALLBACK callback function (webservices.h)
Handles the WsOpenListener call for a WS_CUSTOM_CHANNEL_BINDING.
Syntax
WS_OPEN_LISTENER_CALLBACK WsOpenListenerCallback;
HRESULT WsOpenListenerCallback(
[in] void *listenerInstance,
[in] const WS_STRING *url,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
)
{...}
Parameters
[in] listenerInstance
The pointer to the state specific to this listener instance, as created by the WS_CREATE_LISTENER_CALLBACK.
[in] url
The URL to listen on. The format and interpretation of the URL is defined by the custom listener.
[in, optional] asyncContext
Information on how to invoke the function asynchronously, or NULL if invoking synchronously.
[in, optional] error
Specifies where additional error information should be stored if the function fails.
Return value
Return code | Description |
---|---|
|
The asynchronous operation is still pending. |
|
The listener was aborted during the open, or before the open. |
|
The listener is in the incorrect state. |
|
The address is already being used. |
|
The address is not valid for this context. |
|
A quota was exceeded. |
|
The operation was aborted. |
|
The operation did not complete within the time allotted. |
|
Ran out of memory. |
|
One or more arguments are invalid. |
|
This function may return other errors not listed above. |
Remarks
See WsOpenListener for information about the contract of this API.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 7 [desktop apps only] |
Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
Target Platform | Windows |
Header | webservices.h |