LPNSPV2CLIENTSESSIONRUNDOWN Rückruffunktion (ws2spi.h)

Artikel
08/28/2023

Die NSPv2ClientSessionRundown-Funktion benachrichtigt einen Namespacedienstanbieter der Version 2 (NSPv2), dass die Clientsitzung beendet wird.

Syntax

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

void Lpnspv2clientsessionrundown(
  [in] LPGUID lpProviderId,
  [in] LPVOID pvClientSessionArg
)
{...}

Parameter

[in] lpProviderId

Ein Zeiger auf die GUID des zu benachrichtigenden Namespaceanbieters.

[in] pvClientSessionArg

Ein Zeiger auf die Clientsitzung, die beendet wird.

Rückgabewert

Die Funktion sollte NO_ERROR (null) zurückgeben, wenn die Routine erfolgreich ist. Es sollte SOCKET_ERROR (d. h. 1) zurückgeben, wenn bei der Routine ein Fehler auftritt und der entsprechende Fehlercode mithilfe von WSASetLastError festgelegt werden muss.

Fehlercode	Bedeutung
WSA_NOT_ENOUGH_MEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
WSAEACCES	Die aufrufende Routine verfügt nicht über ausreichende Berechtigungen zum Installieren des Diensts.
WSAEINVAL	Mindestens ein Parameter war für diesen Anbieter ungültig oder fehlte.
WSAEOPNOTSUPP	Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert. Dieser Fehler kann auch zurückgegeben werden, wenn der angegebene dwControlCode ein nicht erkannter Befehl ist.
WSASERVICE_NOT_FOUND	Der Dienst ist unbekannt. Der Dienst kann nicht im angegebenen Namespace gefunden werden.

Hinweise

Die NSPv2ClientSessionRundown-Funktion wird als Teil der NSPv2-Architektur (Namespace service provider version-2) verwendet, die unter Windows Vista und höher verfügbar ist.

Unter Windows Vista und Windows Server 2008 kann die NSPv2ClientSessionRundown-Funktion nur für Vorgänge auf NS_EMAIL Namespaceanbietern verwendet werden.

Die NSPv2Startup-Funktion wird jedes Mal aufgerufen, wenn ein neuer Clientprozess mithilfe des Namespaceanbieters beginnt. Anbieter können das Clientsitzungsargument verwenden, auf das der parameter ppvClientSessionArg verweist, um Informationen zu dieser Sitzung zu speichern. Wenn im Aufruf der NSPv2Startup-Funktion ein Wert für das Clientsitzungsargument angegeben wurde, wird dasselbe Clientsitzungsargument im parameter pvClientSessionArg an die NSPv2ClientSessionRundown-Funktion übergeben.

Die Funktionen NSPv2Startup, NSPv2ClientSessionRundown und NSPv2Cleanup sind optional, abhängig von den Anforderungen des NSPv2-Anbieters.

Wenn die NSPv2ClientSessionRundown-Funktion nicht implementiert ist, sollten Aufrufe dieser Funktion von einer Stubfunktion abgefangen werden, die WSAEOPNOTSUPP zurückgibt. Der NSPv2-Funktionszeiger auf die nicht implementierte NSPv2ClientSessionRundown-Funktion im NSPV2_ROUTINE Struktur auf die Stubfunktion verweisen sollte.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ws2spi.h