共用方式為

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 來擷取特定的錯誤號碼。

錯誤碼 意義
WSA_INVALID_PARAMETER
 指定的 lpServiceClassId 參數無效。
WSA_NOT_ENOUGH_MEMORY
 記憶體不足，無法執行作業。
WSAEACCES
 呼叫例程沒有足夠的許可權可存取資訊。
WSAEFAULT
 由 lpszServiceClassName 指向的指定緩衝區太小。 傳入較大的緩衝區。
WSAENOBUFS
 沒有可用的緩衝區空間。
WSAEOPNOTSUPP
 參考的物件類型不支援此作業。 某些不支援取得服務類別資訊的命名空間提供者會傳回此錯誤。
WSANO_DATA
 lpServiceClassId 有效，但找不到要求類型的數據。
WSANOTINITIALISED
 尚未初始化 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

另請參閱

WSAStartup

Winsock 函式

Winsock 參考