WebhostUnregisterProtocol Function
Requests that a protocol be unregistered when a listener adapter is shutting down.
Syntax
HRESULT WebhostUnregisterProtocol(
IN DWORD ProtocolHandle
);
Parameters
ProtocolHandle
[IN] A DWORD that represents the protocol to be unregistered.
Return Value
An HRESULT. Possible values include, but are not limited to, those in the following table.
| Value | Definition |
|---|---|
| S_OK | Indicates that the operation was successful. |
| HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS ) | Indicates that there is already a listener adapter registered in this process for this protocol. |
| HRESULT_FROM_WIN32( ERROR_NOT_FOUND ) | Indicates that the protocol was not found. |
Remarks
Before calling this function, the listener adaptor should perform the following tasks:
Request all listener channels to stop (by calling the WebhostCloseAllListenerChannelInstances function).
Wait for the Windows Process Activation Service notification from the PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED callback function. This callback confirms that all the listener channel instances have stopped.
Requirements
| Type | Description |
|---|---|
| Client | - IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016 Technical Preview |
| Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0 |
| Header | Listeneradapter.h |