dsRemoveDsServerA 函式 (ntdsapi.h)

  • 發行項

DsRemoveDsServer 函式會從目錄服務的全域區域移除目錄服務代理程式的所有追蹤， (DSA) 。

語法

NTDSAPI DWORD DsRemoveDsServerA(
  [in]            HANDLE hDs,
  [in]            LPSTR  ServerDN,
  [in, optional]  LPSTR  DomainDN,
  [out, optional] BOOL   *fLastDcInDomain,
  [in]            BOOL   fCommit
);

參數

[in] hDs

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

[in] ServerDN

Null 終止字串的指標，指定要移除之域控制器的完整辨別名稱。

[in, optional] DomainDN

指定 ServerDN 所裝載之網域之 Null 終止字串的指標。 如果此參數為 NULL，則不會執行任何驗證，以確保 ServerDN 是 DomainDN 中的最後一個域控制器。

[out, optional] fLastDcInDomain

如果 ServerDN 是 DomainDN 或 FALSE 中的最後一個 DC，則為布爾值的指標，以接收 TRUE。 如果 DomainDN 為 NULL，此參數會收到 FALSE。

[in] fCommit

包含布爾值，指定是否應該實際移除域控制器。 如果此參數為非零，則會移除 ServerDN 。 如果此參數為零，則會檢查 ServerDN 是否存在，並寫入 fLastDcInDomain ，但不會移除域控制器。

傳回值

如果成功或 Win32 或 RPC 錯誤碼失敗，則傳回 ERROR_SUCCESS 。 可能的錯誤碼包括下列專案。

備註

注意

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

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 ntdsapi.h
程式庫 Ntdsapi.lib
Dll Ntdsapi.dll

另請參閱

域控制器和復寫管理功能

DsBind

DsBindWithCred

DsRemoveDsDomain