DsRemoveDsServerA 函式 (ntdsapi.h)
DsRemoveDsServer 函式會從目錄服務的全域區域移除目錄服務代理程式的所有追蹤。
語法
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
Null 終止字串的指標,指定由 ServerDN裝載的網域。 如果此參數 NULL,則不會執行驗證,以確保 ServerDN 是 DomainDN中的最後一個域控制器。
[out, optional] fLastDcInDomain
如果 ServerDN 是 DomainDN 或 FALSE 中最後一個 DC,則為 Boolean 值的指標,這個值會接收 TRUE。 如果 domainDN
[in] fCommit
包含布爾值,指定是否應該實際移除域控制器。 如果此參數為非零,則會移除 ServerDN。 如果此參數為零,則會檢查 ServerDN 是否存在,並寫入 fLastDcInDomain,但不會移除域控制器。
傳回值
如果成功或 Win32 或 RPC 錯誤碼失敗,則傳回 ERROR_SUCCESS。 可能的錯誤碼包括下列專案。
言論
注意
ntdsapi.h 標頭會根據 UNICODE 預處理器常數的定義,將 DsRemoveDsServer 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
支援的最低伺服器 | Windows Server 2008 |
目標平臺 | 窗戶 |
標頭 | ntdsapi.h |
連結庫 | Ntdsapi.lib |
DLL | Ntdsapi.dll |