GetTypeByNameA 函式 (nspapi.h)

GetTypeByName 函式會擷取名稱所指定網路服務的服務類型 GUID。

注意GetTypeByName 函式是 Windows Sockets 1.1 規格的 Microsoft 特定延伸模組。 此函式已過時。 為了方便 Windows Sockets 1.1 開發人員使用，包含此參考數據。 通訊 協議獨立名稱解析 中詳述的函式提供 Windows Sockets 2 中的對等功能。

 

語法

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

參數

[in] lpServiceName

唯一表示服務名稱之零終止字串的指標。 例如，“MY SNA SERVER”。

[in, out] lpServiceType

要接收全域唯一標識符的變數指標， (GUID) 指定網路服務的型別。 Svcguid.h 頭檔包含數個 GUID 服務類型和宏的定義，可用來處理它們。

Winsock2.h 頭檔不會自動包含 Svcguid.h 頭檔。

傳回值

如果此函式成功，則傳回值為零。

如果函式失敗，傳回值會SOCKET_ERROR ( – 1) 。 若要取得擴充錯誤資訊，請呼叫 GetLastError，這會傳回下列擴充錯誤值。

值	意義
ERROR_SERVICE_DOES_NOT_EXIST	指定的服務類型未知。

備註

注意

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

規格需求

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

另請參閱

GetNameByType

Winsock 函式

Winsock 參考