NSPStartup 函式 (ws2spi.h)

NSPStartup 函式會擷取提供者的動態資訊，例如 DLL 進入點的清單。

初始化時，用戶端會呼叫此函式。 NSPStartup 和 NSPCleanup 函式必須呼叫為配對。所有 NSP 函式都必須從 NSPStartup NSPCleanup/ 配對內呼叫。不需要從 NSPStartupNSPCleanup/ 配對內呼叫 WSC 函式。

語法

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

[in] lpProviderId

要從中傳回進入點的所需提供者。

[out] lpnspRoutines

如果函式呼叫成功，指向提供者進入點的NSP_ROUTINE 結構指標。

如果例程成功，函式應該傳回 NO_ERROR (零) 。如果函式失敗，它應該傳回 SOCKET_ERROR (–1) ，而且必須使用 WSASetLastError 設定適當的錯誤碼。

值	Description
WSA_NOT_ENOUGH_MEMORY	記憶體不足，無法執行這項作業。
WSAEINVAL	此提供者的一或多個參數無效或遺失。
WSAEINVALIDPROCTABLE	程式調用數據表無效。
WSAEOPNOTSUPP	不支援此作業。如果命名空間提供者未實作此函式，就會傳回此錯誤。
WSASYSNOTREADY	NSPStartup 函式目前無法運作，因為它用來提供網路服務的基礎系統目前無法使用。

如需詳細資訊，請參閱 NSP_ROUTINE 結構。