IHttpServer::GetProtocolManagerCustomInterface Method

Article
03/09/2018

Retrieves a custom interface for a protocol manager.

Syntax

virtual HRESULT GetProtocolManagerCustomInterface(  
   IN PCWSTR pProtocolManagerDll,  
   IN PCWSTR pProtocolManagerDllInitFunction,  
   IN DWORD dwCustomInterfaceId,  
   OUT PVOID* ppCustomInterface  
) = 0;

Parameters

pProtocolManagerDll
[IN] A pointer to a string that contains the path to the protocol manager DLL.

pProtocolManagerDllInitFunction
[IN] A pointer to a string that contains the name of the initialization function for the protocol manager.

dwCustomInterfaceId
[IN] A DWORD that contains the ID of the interface to return for the protocol manager.

ppCustomInterface
[OUT] A pointer to a VOID buffer that contains the custom interface.

Return Value

An HRESULT. Possible values include, but are not limited to, those in the following table.

Value	Description
S_OK	Indicates that the operation was successful.
ERROR_FILE_NOT_FOUND	Indicates that the protocol manager specified by `pProtocolManagerDll` does not exist, or that the DLL entry point specified by `pProtocolManagerDllInitFunction` is not valid.
ERROR_INVALID_PARAMETER	Indicates the interface specified by `dwCustomInterfaceId` is not valid.

Remarks

The GetProtocolManagerCustomInterface method exposes the IWpfExposeProtocolManagerCustomInterface::LoadProtocolManagerAndGetCustomInterface method to HTTP modules.

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