NSPStartup-Funktion (ws2spi.h)
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 |
|---|---|
| Es ist nicht genügend Arbeitsspeicher verfügbar, um diesen Vorgang auszuführen. | |
| Mindestens ein Parameter war für diesen Anbieter ungültig oder fehlte. | |
| Die Prozeduraufruftabelle ist ungültig. | |
| Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert. | |
| 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 |