GetNameByTypeA 函式 (nspapi.h)

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

注意GetNameByType 函式是 Windows Sockets 1.1 規格的 Microsoft 特定延伸模組。此函式已過時。為了方便 Windows Sockets 1.1 開發人員，參考數據如下所示。

注意通訊協議獨立名稱解析中詳述的函式提供 Windows Sockets 2 中的對等功能。

語法

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

[in] lpServiceType

指定網路服務類型的全域唯一標識符指標 (GUID) 。 Svcguid.h 頭檔包含數種 GUID 服務類型的定義，以及用來處理它們的宏。

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

[out] lpServiceName

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

[in] dwNameLength

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

如果函式成功，則傳回值不會SOCKET_ERROR (-1) 。

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

注意

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