DsReplicaDelA 函式 (ntdsapi.h)
DsReplicaDel 函式會從目的地命名內容 (NC) 移除複寫來源參考。
語法
NTDSAPI DWORD DsReplicaDelA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaSrc,
[in] ULONG Options
);
參數
[in] hDS
包含從 DSBind 或 DSBindWithCred 函式取得的目錄服務句柄。
[in] NameContext
常數 Null 終止字串的指標,指定要從中移除複本之目的地 NC 的辨別名稱 (DN) 。 目的地 NC 記錄必須以物件、具現化或不具現化或參考虛設的形式存在於本機,例如 GUID 的虛設。
[in] DsaSrc
常數 Null 終止的 Unicode 字串指標,指定來源目錄系統代理程式 (DSA) 的傳輸特定位址。 此來源伺服器是由字串名稱來識別,而不是由其 UUID來識別。 適用於 DsaSrc 的字串名稱通常是以 GUID為基礎的 DNS 名稱,其中名稱 GUID 部分是來源伺服器的 nTDSDSA 物件的 GUID。
[in] Options
傳遞用來處理要求的其他數據。 此參數可以是下列值的組合。
DS_REPDEL_ASYNCHRONOUS_OPERATION
以異步方式執行這項作業。
DS_REPDEL_IGNORE_ERRORS
忽略從連絡來源所產生的任何錯誤,指示其從其復寫的伺服器清單中移除此 NC。
DS_REPDEL_INTERSITE_MESSAGING
表示複本是以郵件為基礎,而不是使用原生目錄服務 RPC 進行同步處理。
DS_REPDEL_LOCAL_ONLY
請勿連絡來源,告知其從其復寫的伺服器清單中移除此 NC。 如果未設定此旗標,且連結是以 RPC 為基礎,則會連絡來源。
DS_REPDEL_NO_SOURCE
刪除 NC 中的所有物件。 此選項僅適用於沒有來源的唯讀DC。
DS_REPDEL_REF_OK
允許刪除只讀複本,即使它來源為其他只讀複本也一樣。
DS_REPDEL_WRITEABLE
表示已刪除的複本可以寫入 。
傳回值
如果函式成功,則傳回值會 ERROR_SUCCESS。
如果函式失敗,則傳回值是標準 Win32 API 錯誤,如果參數無效,則為 ERROR_INVALID_PARAMETER。
言論
注意
ntdsapi.h 標頭會將 DsReplicaDel 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
支援的最低伺服器 | Windows Server 2008 |
目標平臺 | 窗戶 |
標頭 | ntdsapi.h |
連結庫 | Ntdsapi.lib |
DLL | Ntdsapi.dll |