LPNSPCLEANUP-Rückruffunktion (ws2spi.h)

  • Artikel

Die NSPCleanup-Funktion beendet die Verwendung eines bestimmten Windows Sockets-Namespace-Dienstanbieters.

Syntax

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

Parameter

[in] lpProviderId

Ein Zeiger auf die GUID des zu beendenden Namespaceanbieters.

Rückgabewert

Wenn kein Fehler auftritt, gibt NSPCleanup den Wert NO_ERROR (null) zurück. Andernfalls wird SOCKET_ERROR (–1) zurückgegeben, und der Anbieter muss den entsprechenden Fehlercode mithilfe von WSASetLastError festlegen.

Fehlercode Bedeutung
WSA_NOT_ENOUGH_MEMORY Es ist nicht genügend Arbeitsspeicher verfügbar, um diesen Vorgang auszuführen.
WSAEINVAL Der lpProviderId-Parameter gibt keinen gültigen Anbieter an.
WSAEOPNOTSUPP Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert.

Hinweise

Die NSPCleanup-Funktion wird aufgerufen, wenn eine Anwendung mit einem Windows Sockets-Namespacedienstanbieter abgeschlossen ist. Die NSPCleanup-Funktion hebt die Registrierung eines bestimmten Namespaceanbieters auf und ermöglicht es dem Transportdienstanbieter, alle zugeordneten Ressourcen des Namespaceanbieters freizugeben.

Die NSPStartup-Funktion muss erfolgreich aufgerufen werden, bevor Namespaceanbieter verwendet werden. Es ist zulässig, mehr als einen NSPStartup-Aufruf zu tätigen. Für jeden NSPStartup-Aufruf muss jedoch auch ein entsprechender NSPCleanup-Aufruf ausgegeben werden. Nur die endgültige NSPCleanup für den Dienstanbieter führt die eigentliche Bereinigung durch; Durch die vorherigen Aufrufe wird eine interne Verweisanzahl im Dienstanbieter verringert.

Diese Funktion sollte erst zurückgegeben werden, wenn die DLL des Namespacedienstanbieters aus dem Arbeitsspeicher entladen werden kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ws2spi.h

Weitere Informationen