NSPStartup-Funktion (ws2spi.h)

  • Artikel

Die NSPStartup-Funktion ruft die dynamischen Informationen zu einem Anbieter ab, z. B. die Liste der DLL-Einstiegspunkte.

Diese Funktion wird vom Client bei der Initialisierung aufgerufen. Die Funktionen NSPStartup und NSPCleanup müssen als Paare aufgerufen werden. Alle NSP-Funktionen müssen innerhalb eines NSPStartup/NSPCleanup-Paars aufgerufen werden. Es ist nicht erforderlich, dass WSC-Funktionen aus einemNSPStartup-NSPCleanup-Paar/ aufgerufen werden.

Syntax

INT WSAAPI NSPStartup(
  [in]  LPGUID        lpProviderId,
  [out] LPNSP_ROUTINE lpnspRoutines
);

Parameter

[in] lpProviderId

Der gewünschte Anbieter, von dem die Einstiegspunkte zurückgegeben werden sollen.

[out] lpnspRoutines

Ein Zeiger auf eine NSP_ROUTINE Struktur, die auf Anbietereinstiegspunkte verweist, wenn der Funktionsaufruf erfolgreich ist.

Rückgabewert

Die Funktion sollte NO_ERROR (null) zurückgeben, wenn die Routine erfolgreich ist. Es sollte SOCKET_ERROR (–1) zurückgeben, wenn die Funktion fehlschlägt und der entsprechende Fehlercode mithilfe von WSASetLastError festgelegt werden muss.

Wert BESCHREIBUNG
WSA_NOT_ENOUGH_MEMORY
 Es ist nicht genügend Arbeitsspeicher verfügbar, um diesen Vorgang auszuführen.
WSAEINVAL
 Mindestens ein Parameter war für diesen Anbieter ungültig oder fehlte.
WSAEINVALIDPROCTABLE
 Die Prozeduraufruftabelle ist ungültig.
WSAEOPNOTSUPP
 Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert.
WSASYSNOTREADY
 Die NSPStartup-Funktion kann derzeit nicht ausgeführt werden, da das zugrunde liegende System, das zum Bereitstellen von Netzwerkdiensten verwendet wird, derzeit nicht verfügbar ist.

Hinweise

Weitere Informationen finden Sie in der NSP_ROUTINE-Struktur .

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

NSPCleanup

NSP_ROUTINE

WSASetLastError