DsReplicaModifyA 函式 (ntdsapi.h)

DsReplicaModify 函式會修改目的地命名內容的現有復寫來源參考。

語法

NTDSAPI DWORD DsReplicaModifyA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           Options
);

參數

[in] hDS

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

[in] NameContext

常數 null 終止字串的指標，指定目的地命名內容 (NC) 的辨別名稱 (DN) 。

[in] pUuidSourceDsa

來源目錄系統代理程式的 UUID 指標， (DSA) 。 如果 ModifyFields 不包含 DS_REPMOD_UPDATE_ADDRESS ，且 SourceDsaAddress 不是 NULL，此參數可能是 Null。

[in] TransportDn

保留供未來使用。 NULL 以外的任何值都會導致傳回ERROR_NOT_SUPPORTED。

[in] SourceDsaAddress

常數 Null 終止的 Unicode 字串指標，指定來源 DSA 的傳輸特定位址。 如果 pUuidSourceDsa 不是 NULL 且 ModifyFields 不包含 DS_REPMOD_UPDATE_ADDRESS，則會忽略此參數。

[in] pSchedule

包含複寫來源之復寫排程數據的 SCHEDULE 結構的指標。 此參數是選擇性的，如果沒有使用，則可以是 NULL 。 如果 ModifyFields 包含DS_REPMOD_UPDATE_SCHEDULE旗標 ， 則需要此參數。

[in] ReplicaFlags

此參數是用來控制複寫行為，而且可以採用下列值。

DS_REPL_NBR_SYNC_ON_STARTUP

當目的地伺服器開機時，會嘗試從這個來源複寫此命名內容。 這項作業通常僅適用於站台內的鄰居。

DS_REPL_NBR_DO_SCHEDULED_SYNCS

根據排程來執行複寫。 除非此命名內容和來源的排程是「永不」，也就是空的排程，否則通常會設定此旗標。

DS_REPL_NBR_TWO_WAY_SYNC

如果設定，表示輸入複寫完成時，目的地伺服器必須告訴來源伺服器以反向方向同步處理。 這項功能會用於撥接的案例，此時兩部伺服器中只有一部可以啟始撥接連線。 例如，這個選項可用於總公司和分公司，其中分公司可利用撥接 ISP 連線的方式透過網際網路連接到總公司。

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

此芳鄰設定為停用以通知為基礎的同步處理。 在站台中，網域控制站會根據變更發生時的告知來彼此進行同步化。 此設定可防止此芳鄰執行通知所觸發的同步處理。 芳鄰仍會根據其排程或回應手動要求的同步處理來執行同步處理。

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

此芳鄰設定為不會根據其排程執行同步處理。 這個鄰近執行同步處理的唯一方式是回應變更通知或手動要求的同步處理。

DS_REPL_NBR_COMPRESS_CHANGES

從這個來源收到的變更將會壓縮。 這通常只有在來源伺服器位於不同的月臺時才會設定。

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

不應該從這個來源接收變更告知。 這通常只有在來源伺服器位於不同的月臺時才會設定。

[in] ModifyFields

指定應該修改哪些欄位。 在 ModifyFields中必須至少指定一個字段。 此參數可以是下列值的組合。

DS_REPMOD_UPDATE_ADDRESS

匯報 與參考伺服器相關聯的位址。

DS_REPMOD_UPDATE_FLAGS

匯報與複本相關聯的旗標。

DS_REPMOD_UPDATE_RESULT

未使用。 目前不支援指定結果值的更新。 結果值預設為 0。

DS_REPMOD_UPDATE_SCHEDULE

匯報 與複本相關聯的定期複寫排程。

DS_REPMOD_UPDATE_TRANSPORT

匯報 與複本相關聯的傳輸。

[in] Options

傳遞用來處理要求的其他數據。 此參數可以是下列值的組合。

DS_REPMOD_ASYNCHRONOUS_OPERATION

以異步方式執行這項作業。

DS_REPMOD_WRITEABLE

指出要修改的複本可以寫入其中。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，傳回值可以是下列其中一項。

備註

規格需求

另請參閱

域控制器和復寫管理功能

DsReplicaAdd

DsReplicaDel

DsReplicaSync

DsReplicaUpdateRefs

附表