PFN_WEBHOST_LISTENER_APPLICATION_POOL_IDENTITY_CHANGED-Funktion

Artikel
07/19/2023

Benachrichtigt den Listeneradapter, dass sich eine Anwendungspoolidentität geändert hat.

Syntax

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

Parameter

pContext
[IN] Ein Zeiger auf einen VOID Kontext, den der Listeneradapter an WebhostRegisterProtocol übergeben hat.

AppPoolId
[IN] Ein Zeiger auf eine Zeichenfolge, die den Anwendungspool mit der geänderten Identität enthält.

PSID
[IN] Ein Zeiger auf einen Wert des Sicherheitsbezeichners (Security Identifier, SID), der die neue Identität der Workerprozesse enthält.

Rückgabewert

VOID.

Bemerkungen

Ein Listeneradapter, der diese Routine blockiert, kann alle anderen Im Anwendungspool daran hindern, Workerprozesse zu starten. Der Listeneradapter startet Workerprozesse (W3wp.exe) nicht direkt, kann aber deren Start auslösen (wenn keine W3wp.exe Datei für den Anwendungspool ausgeführt wird), indem er einen Listenerkanal für den Anwendungspool anfordert.

Der Windows-Prozessaktivierungsdienst (Windows Process Activation Service, WAS) wird vorhandene Workerprozesse nicht wiederverwendet und neue Prozesse gestartet, bis alle Listeneradapter die Identitätsänderung bestätigen. Wenn mehrere Listeneradapter für denselben Anwendungspool konfiguriert sind und einer der Listeneradapter diesen Aufruf blockiert, wird verhindert, dass der neue Workerprozess gestartet wird.

Der WAS ruft diese Funktion asynchron auf und wartet nicht auf den Abschluss der Benachrichtigung.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 auf Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 auf Windows Server 2016
Produkt	– 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 für `PSID`

Weitere Informationen

Rückruffunktionen des Listeneradapters
WebhostRegisterProtocol-Funktion

Freigeben über