LPNSPGETSERVICECLASSINFO 回呼函式 (ws2spi.h)

發行項
08/28/2023

NSPGetServiceClassInfo函式會擷取與命名空間提供者相關的所有相關類別資訊 (架構) 。此呼叫會擷取服務所有實例通用的任何命名空間特定資訊，包括 SAP 的連線資訊，或 SAP 或 TCP 的埠資訊。

語法

LPNSPGETSERVICECLASSINFO Lpnspgetserviceclassinfo;

INT Lpnspgetserviceclassinfo(
  [in]      LPGUID lpProviderId,
  [in, out] LPDWORD lpdwBufSize,
  [in, out] LPWSASERVICECLASSINFOW lpServiceClassInfo
)
{...}

參數

[in] lpProviderId

要從中擷取服務類別架構之特定命名空間提供者之 GUID 的指標。

[in, out] lpdwBufSize

在輸入時， lpServiceClassInfo 參數所指向緩衝區的大小，以位元組為單位。

在輸出中，如果函式失敗且錯誤為 WSAEFAULT，此參數會指定擷取記錄所需的 lpServiceClassInfo 參數所指向之緩衝區的最小大小，以位元組為單位。

[in, out] lpServiceClassInfo

傳回 WSASERVICECLASSINFOW 結構的指標，其中包含命名空間特定對應資訊的服務類別。必須填入 lpServiceClassId 參數，以指出應該傳回哪些 WSASERVICECLASSINFOW 記錄。

傳回值

如果沒有發生錯誤， NSPGetServiceClassInfo 函式會傳回 NO_ERROR (零) 。否則會傳回 SOCKET_ERROR (-1) ，而且命名空間提供者必須使用 WSASetLastError設定適當的錯誤碼。

錯誤碼	意義
WSA_NOT_ENOUGH_MEMORY	記憶體不足，無法執行這項作業。
WSAEACCES	呼叫常式沒有足夠的許可權可存取訊號。
WSAEFAULT	lpServiceClass參數指向的緩衝區太小，無法包含WSASERVICECLASSINFOW結構。應用程式必須傳入較大的緩衝區。
WSAEINVAL	指定的服務類別識別碼或命名空間提供者識別碼無效。如果 lpProviderId、 lpServiceClassId、 lpdwBufSize或 lpServiceClassInfo 參數是 Null，就會傳回此錯誤。
WSAEOPNOTSUPP	不支援此作業。如果命名空間提供者未實作此函式，就會傳回此錯誤。
WSANO_DATA	要求的名稱有效，但找不到所要求類型的資料。
WSATYPE_NOT_FOUND	找不到指定的類別。

備註

W2_32.dll 使用此函式來實作 WSAGetServiceClassNameByClassId 函式，以及擷取傳遞至 NSPLookupServiceBegin 和 NSPSetService 函式的命名空間特定資訊。

規格需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	ws2spi.h