PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED Function

Article
03/09/2018

Notifies the listener adapter that the WebhostRegisterProtocol function call was successful and the configuration manager has connected.

Syntax

typedef VOID(* PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED )(  
  IN VOID* pContext  
);

Parameters

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

Return Value

VOID.

Remarks

This is the first callback function invoked by the client library. After this call, the listener adapter should set up the listener to wait on incoming requests.

You should set a time-out for the listener adapter to wait for this callback function. If the time-out expires, you should stop the listener adapter service and mark it as failed.

The listener adapter should be in a clean state (no configuration information set) when it receives this call.

You should not set the listener service status to SERVICE_RUNNING from this callback function. You should set the service status to SERVICE_RUNNING only when initialization is complete and the protocol listener is listening (typically after the PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED notification).

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