DsGetSiteNameA 函式（dsgetdc.h）

DsGetSiteName 函式會傳回電腦所在月臺的名稱。對於域控制器（DC），月臺的名稱是所設定 DC 的位置。針對成員工作站或成員伺服器，名稱會指定計算機網域中所設定的工作站月臺。

語法

DSGETDCAPI DWORD DsGetSiteNameA(
  [in]  LPCSTR ComputerName,
  [out] LPSTR  *SiteName
);

[in] ComputerName

Null 終止字串的指標，指定要傳送此函式的伺服器名稱。 NULL 表示本機電腦。

[out] SiteName

變數的指標，這個變數會接收指定此電腦月臺位置之 Null 終止字串的指標。此字串是由系統配置，而且必須使用 netApiBufferFree 函式釋放。

如果函式傳回帳戶資訊，則傳回值會 NO_ERROR。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

DsGetSiteName 函式不需要任何特定存取指定的網域。函式會傳送至 ComputerName所指定電腦上的 “NetLogon” 服務。

注意

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