Freigeben über

WebhostRegisterProtocol-Funktion

Deklariert das Protokoll, das der Listeneradapter unterstützt.

Syntax

HRESULT WebhostRegisterProtocol(  
   IN LPCWSTR ProtocolId,  
   IN VOID* pListenerCallbacks,  
   IN VOID* pContext,  
   OUT DWORD* pProtocolHandle  
);

Parameter

ProtocolId
[IN] Eine Zeichenfolge, die das Protokoll enthält, das dieser Listeneradapter unterstützt.

pListenerCallbacks
[IN] Ein VOID Zeiger auf die WEBHOST_LISTENER_CALLBACKS-Struktur .

pContext
[IN] Ein beliebiger Zeiger VOID , den der Listeneradapter übergeben wird.

pProtocolHandle
[OUT] Ein Zeiger auf einen DWORD , der den prozessspezifischen Schlüssel enthält, der dieses Protokoll darstellt.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert Definition
S_OK Gibt an, dass der Vorgang erfolgreich war.
HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS ) Gibt an, dass bereits ein Listeneradapter für dieses Protokoll registriert ist.
E_INVALIDARG Gibt an, dass einer der Parameter ungültig ist.
E_OUTOFMEMORY Gibt an, dass der Heapspeicher erschöpft ist.

Bemerkungen

Sie müssen die WebhostRegisterProtocol Funktion zuerst aufrufen, wenn Sie einen Listeneradapter starten. WebhostRegisterProtocol ist asynchron, sodass eine erfolgreiche Rückgabe nicht garantiert, dass der Aufruf erfolgreich war. Der Windows-Prozessaktivierungsdienst (WAS) benachrichtigt den Listener über eine erfolgreiche Registrierung mithilfe der funktion PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED . PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED wird im pListenerCallbacks Parameter an diesen Aufruf übergeben.

Sie sollten ein Timeout festlegen, damit der Listeneradapter auf die PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED Rückruffunktion wartet. Wenn das Timeout abläuft, sollten Sie den Listeneradapterdienst beenden und als fehlgeschlagen markieren. Eine erfolgreiche Rückgabe dieses Aufrufs gibt an, dass die Clientbibliothek auf den Windows-Prozessaktivierungsdienst wartet und nach Möglichkeit eine Verbindung herstellt.

Sie sollten den Listenerdienst status nicht auf SERVICE_RUNNING dieser Rückruffunktion festlegen. Sie sollten den Dienst status nur auf SERVICE_RUNNING festlegen, wenn die Initialisierung abgeschlossen ist und der Protokolllistener lauscht (in der Regel nach der PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED Benachrichtigung).

Der pContext Parameter wird immer dann an den Listeneradapter übergeben, wenn eine Rückruffunktion aufgerufen wird. Sie kann verwendet werden, wenn mehrere Protokolle implementiert werden, die dieselbe Rückrufstruktur verwenden.

Damit die Clientbibliothek eine Verbindung mit dem Windows-Prozessaktivierungsdienst herstellen kann, müssen die folgenden Bedingungen erfüllt sein:

  • Der <listenerAdapters> Konfigurationsabschnitt in der Was.config-Datei muss das Protokoll und die Identität deklarieren, unter der die Listeneradapter ausgeführt werden.

  • Der Windows-Prozessaktivierungsdienst muss ausgeführt werden.

  • Listeneradapterdienste sollten als abhängig vom Windows-Prozessaktivierungsdienst registriert werden.

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 unter 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 unter 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

Weitere Informationen

PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED-Funktion
Exportierte Funktionen des Listeneradapters

  • Last updated on