dsReplicaDelA 函式 (ntdsapi.h)

DsReplicaDel 函式會從目的地命名內容中移除復寫來源參考, (NC) 。

語法

NTDSAPI DWORD DsReplicaDelA(
  [in] HANDLE hDS,
  [in] LPCSTR NameContext,
  [in] LPCSTR DsaSrc,
  [in] ULONG  Options
);

參數

[in] hDS

包含從 DSBindDSBindWithCred 函式取得的目錄服務句柄。

[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
目標平台 Windows
標頭 ntdsapi.h
程式庫 Ntdsapi.lib
Dll Ntdsapi.dll

另請參閱

域控制器和復寫管理功能

DsReplicaAdd

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs