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 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。