WSAGetServiceClassInfoW 函式 (winsock2.h)

發行項
03/04/2024

WSAGetServiceClassInfo 函式會從指定的命名空間提供者擷取與指定服務類別相關的類別資訊 (架構) 。

語法

INT WSAAPI WSAGetServiceClassInfoW(
  [in]      LPGUID                 lpProviderId,
  [in]      LPGUID                 lpServiceClassId,
  [in, out] LPDWORD                lpdwBufSize,
  [out]     LPWSASERVICECLASSINFOW lpServiceClassInfo
);

參數

[in] lpProviderId

識別特定命名空間提供者之 GUID 的指標。

[in] lpServiceClassId

識別服務類別之 GUID 的指標。

[in, out] lpdwBufSize

在輸入時， lpServiceClassInfo 參數所指向之緩衝區中包含的位元元組數目。

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

[out] lpServiceClassInfo

WSASERVICECLASSINFO 結構的指標，其中包含來自指定服務類別之指定命名空間提供者的服務類別資訊。

傳回值

如果 WSAGetServiceClassInfo 成功，則傳回值為零。否則，會傳回SOCKET_ERROR值，並呼叫 WSAGetLastError 來擷取特定的錯誤號碼。

錯誤碼	意義
WSA_NOT_ENOUGH_MEMORY	記憶體不足，無法執行作業。
WSAEACCES	呼叫例程沒有足夠的許可權可存取資訊。
WSAEFAULT	lpServiceClassInfo 參數指向的緩衝區太小，無法包含 WSASERVICECLASSINFOW。應用程式必須傳入較大的緩衝區。
WSAEINVAL	指定的服務類別識別碼或命名空間提供者標識碼無效。如果 lpProviderId、 lpServiceClassId、 lpdwBufSize 或 lpServiceClassInfo 參數為 NULL，就會傳回此錯誤。
WSAEOPNOTSUPP	參考的物件類型不支援此作業。某些不支援取得服務類別資訊的命名空間提供者會傳回此錯誤。
WSANO_DATA	要求的名稱有效，但找不到所要求類型的數據。
WSANOTINITIALISED	尚未初始化 WS2_32.DLL。應用程式必須先呼叫 WSAStartup ，再呼叫任何 Windows Sockets 函式。
WSATYPE_NOT_FOUND	找不到指定的類別。

備註

WSAGetServiceClassInfo 函式會從命名空間提供者擷取服務類別資訊。從特定命名空間提供者擷取的服務類別資訊可能不是安裝服務類別時所指定的一組完整類別資訊。個別命名空間提供者只需要保留服務類別資訊，這些資訊適用於其支援的命名空間。如需詳細資訊，請參閱服務類別數據結構一節。

注意

winsock2.h 標頭會將 WSAGetServiceClassInfo 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	winsock2.h
程式庫	Ws2_32.lib
Dll	Ws2_32.dll