PFN_WEBHOST_LISTENER_APPLICATION_CREATED Function

Article
03/09/2018

Notifies the listener adapter that an application configured for the listener associated with this listener adapter has been created. The listener adapter can choose whether to configure this application with the listener.

Syntax

typedef VOID(* PFN_WEBHOST_LISTENER_APPLICATION_CREATED)(  
   IN VOID* pContext,  
   IN LPCWSTR AppKey,  
   IN LPCWSTR Path,  
   IN DWORD SiteId,  
   IN LPCWSTR AppPoolId,  
   IN PBYTE Bindings,  
   IN DWORD NumberOfBindings,  
   IN BOOL RequestsBlocked  
);

Parameters

pContext
[IN] A pointer to a VOID context that the listener adapter passed to WebhostRegisterProtocol.

AppKey
[IN] A pointer to a string that contains the key for finding the application domain.

Path
[IN] A pointer to a string that contains the URL minus the bindings.

SiteId
[IN] A DWORD that contains the site identifier under which the application runs.

AppPoolId
[IN] A pointer to a string that contains the application pool to which this application should be routed.

Bindings
[IN] A pointer to a BYTE value that contains a collection of binding information that is used with the path to make up the URLs for this application.

NumberOfBindings
[IN] A DWORD that contains the number of bindings in the Bindings parameter.

RequestsBlocked
[IN] true to notify the listener adapter to listen on this application but not process requests on an unsupported protocol; false to send requests to parent applications when the child does not support the protocol.

Return Value

VOID.

Remarks

You should save the AppKey parameter with the application so it can be passed to the process protocol handler. The process protocol handler will inform the protocol manager to launch the application domain specified in AppKey.

PBYTE is declared in the WinDef.h header file.

The Windows Process Activation Service (WAS) calls this function asynchronously and does not wait for the completion of the notification.

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