GetNameByTypeA 函式（nspapi.h）

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

Note GetNameByType 函式是 Windows Sockets 1.1 規格Microsoft 特定擴充功能。此函式已經過時。為了方便 Windows Sockets 1.1 開發人員，參考數據如下所示。

注意Protocol-Independent 名稱解析中詳述的函式在 Windows Sockets 2 中提供對等的功能。

語法

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

[in] lpServiceType

指定網路服務類型的全域唯一標識碼（GUID）指標。 Svcguid.h 頭檔包含數個 GUID 服務類型的定義，以及用來處理它們的巨集。

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

[out] lpServiceName

緩衝區的指標，接收以唯一表示網路服務名稱的零終止字串。

[in] dwNameLength

在輸入時，變數的指標會指定 lpServiceName 所指向之緩衝區的大小，以位元組為單位。在輸出中，變數包含服務名稱字串的實際大小，以位元組為單位。

如果函式成功，則傳回值不會SOCKET_ERROR （–1）。

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

注意

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

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