PFN_WEBHOST_LISTENER_APPLICATION_POOL_IDENTITY_CHANGED Function

Artikel
03/09/2018

Notifies the listener adapter that an application pool identity has changed.

Syntax

typedef VOID(* FN_WEBHOST_LISTENER_APPLICATION_POOL_IDENTITY_CHANGED)(  
   IN VOID* pContext,  
   IN LPCWSTR AppPoolId,  
   IN PSID pSID  
);

Parameters

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

AppPoolId
[IN] A pointer to a string that contains the application pool with the changed identity.

PSID
[IN] A pointer to a security identifier (SID) value that contains the new identity of the worker processes.

Return Value

VOID.

Remarks

A listener adapter that is blocking this routine can block all others in the application pool from starting worker processes. The listener adapter does not directly start worker processes (W3wp.exe), but it can trigger their start (when no W3wp.exe file is running for the application pool) by requesting a listener channel for the application pool.

The Windows Process Activation Service (WAS) does not recycle existing worker processes and start new ones until all listener adapters acknowledge the identity change. If multiple listener adapters are configured for the same application pool, and one of the listener adapters blocks this call, it will prevent the new worker process from starting.

The 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, Windows.h for `PSID`

Freigeben über