共用方式為

DsListServersForDomainInSiteA 函式 （ntdsapi.h）

  • 發行項

DsListServersForDomainInSite 函式會列出網站中網域中的所有伺服器。

語法

NTDSAPI DWORD DsListServersForDomainInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           domain,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppServers
);

參數

[in] hDs

包含從 DSBind 或 DSBindWithCred 函式取得的目錄服務句柄。

[in] domain

指定功能變數名稱之 Null 終止字串的指標。 此字串必須與 dsListDomainsInSite 函 式所傳回的其中一個字串相同。

[in] site

指定月台名稱之 Null 終止字串的指標。 此字串取自 DsListSites 函式所傳回的網站名稱清單。

[out] ppServers

指向接收網域中伺服器清單之 DS_NAME_RESULT 結構的指標。 傳回的結構必須使用 DsFreeNameResult 函式來釋放。

傳回值

如果函式傳回伺服器清單，則傳回值會 NO_ERROR。 如果函式失敗，傳回值可以是下列其中一個錯誤碼。

言論

傳回的 DS_NAME_RESULT 結構中會報告個別名稱轉換錯誤。

注意

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

要求

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

另請參閱

DS_NAME_RESULT

域控制器和復寫管理功能

DsFreeNameResult