WSAGetServiceClassNameByClassIdA 函式 (winsock2.h)
WSAGetServiceClassNameByClassId 函式會擷取與指定型別相關聯的服務名稱。 此名稱是一般服務名稱,例如 FTP 或 SNA,而不是該服務的特定實例名稱。
語法
INT WSAAPI WSAGetServiceClassNameByClassIdA(
[in] LPGUID lpServiceClassId,
[out] LPSTR lpszServiceClassName,
[in, out] LPDWORD lpdwBufferLength
);
參數
[in] lpServiceClassId
服務類別之 GUID 的指標。
[out] lpszServiceClassName
服務名稱的指標。
[in, out] lpdwBufferLength
在輸入時, lpszServiceClassName 所傳回的緩衝區長度,以字元為單位。 輸出時,以字元為單位複製到 lpszServiceClassName 的服務名稱長度。
傳回值
如果成功, WSAGetServiceClassNameByClassId 函式會傳回零的值。 否則,會傳回SOCKET_ERROR值,並呼叫 WSAGetLastError 來擷取特定的錯誤號碼。
錯誤碼 | 意義 |
---|---|
指定的 lpServiceClassId 參數無效。 | |
記憶體不足,無法執行作業。 | |
呼叫例程沒有足夠的許可權可存取資訊。 | |
由 lpszServiceClassName 指向的指定緩衝區太小。 傳入較大的緩衝區。 | |
沒有可用的緩衝區空間。 | |
參考的物件類型不支援此作業。 某些不支援取得服務類別資訊的命名空間提供者會傳回此錯誤。 | |
lpServiceClassId 有效,但找不到要求類型的數據。 | |
尚未初始化 WS2_32.DLL。 應用程式必須先呼叫 WSAStartup ,再呼叫任何 Windows Sockets 函式。 |
備註
注意
winsock2.h 標頭會根據 UNICODE 預處理器常數的定義,將 WSAGetServiceClassNameByClassId 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | winsock2.h |
程式庫 | Ws2_32.lib |
Dll | Ws2_32.dll |