共用方式為

GetTypeByNameA 函式 （nspapi.h）

  • 發行項

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

NoteGetTypeByName 函式是 Windows Sockets 1.1 規格的Microsoft特定擴充功能。 此函式已經過時。 為了方便 Windows Sockets 1.1 開發人員，其中包含此參考數據。 Protocol-Independent 名稱解析 中詳述的函式在 Windows Sockets 2 中提供對等的功能。
 

語法

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

參數

[in] lpServiceName

以零結尾字串的指標，唯一表示服務的名稱。 例如，“MY SNA SERVER”。

[in, out] lpServiceType

要接收全域唯一標識符的變數指標（GUID），指定網路服務的型別。 Svcguid.h 標頭檔包含數個 GUID 服務類型和巨集的定義，以使用這些配置檔。

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

傳回值

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

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

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

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 nspapi.h
連結庫 Mswsock.lib
DLL Mswsock.dll

另請參閱

GetNameByType

Winsock 函式

Winsock 參考