共用方式為

DsAddressToSiteNamesA 函式 （dsgetdc.h）

  • 發行項

DsAddressToSiteNames 函式會取得對應至指定地址的網站名稱。

語法

DSGETDCAPI DWORD DsAddressToSiteNamesA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames
);

參數

[in, optional] ComputerName

Null 終止字串的指標，指定要處理此函式之遠端伺服器的名稱。 此參數必須是域控制器的名稱。 非域控制器可以呼叫 DsGetDcName 來尋找域控制器，以呼叫此函式。

[in] EntryCount

包含 SocketAddresses 陣列中的元素數目。

[in] SocketAddresses

包含 SOCKET_ADDRESS 結構的陣列，其中包含要轉換的位址。 這個陣列中的每個位址都必須是類型 AF_INET。 EntryCount 包含此陣列中的元素數目。

[out] SiteNames

接收包含地址網站名稱的 Null 終止字串指標數位。 此陣列中的每個元素都會對應至 SocketAddresses 陣列中的相同元素。 如果對應的位址未對應至任何已知網站，或是地址專案的格式不正確，則元素 NULL。 呼叫者呼叫 netApiBufferFree 不再需要此陣列時，呼叫者必須釋放此陣列。

傳回值

如果成功或 Win32 或 RPC 錯誤，則傳回 NO_ERROR 否則傳回 。 下列清單列出可能的錯誤碼。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows Vista
支援的最低伺服器 Windows Server 2008
目標平臺 窗戶
標頭 dsgetdc.h
連結庫 Netapi32.lib
DLL Netapi32.dll

另請參閱

Directory Service Functions

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree