DsReplicaUpdateRefsA 函式 （ntdsapi.h）
DsReplicaUpdateRefs 函式會從來源命名內容新增或移除目的地的復寫參考。
語法
NTDSAPI DWORD DsReplicaUpdateRefsA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaDest,
[in] const UUID *pUuidDsaDest,
[in] ULONG Options
);
參數
[in] hDS
包含從 DSBind 或 DSBindWithCred 函式取得的目錄服務句柄。
[in] NameContext
常數 Null 終止字串的指標，指定來源命名內容的辨別名稱。
[in] DsaDest
常數 Null 終止字串的指標，指定目的地目錄系統代理程式的傳輸特定位址。
[in] pUuidDsaDest
包含目的地目錄系統代理程式之 UUID 值的指標。
[in] Options
包含一組旗標，提供用來處理要求的其他數據。 這可以是零或下列一或多個值的組合。
DS_REPUPD_ADD_REFERENCE
目的地的參考會新增至來源伺服器。
DS_REPUPD_ASYNCHRONOUS_OPERATION
作業會以異步方式執行。
DS_REPUPD_DELETE_REFERENCE
目的地的參考會從來源伺服器中移除。
DS_REPUPD_WRITEABLE
新增或移除之復本的參考是可寫入的。 否則，它是只讀的。
傳回值
如果函式成功，則會傳回 ERROR_SUCCESS。
如果函式失敗，傳回值可以是下列其中一項。
言論
如果在 Options 參數中同時設定 DS_REPUPD_ADD_REFERENCE 和 DS_REPUPD_DELETE_REFERENCE，則會在伺服器上新增目的地的參考。 如果目的地的參考已經存在，則會更新參考。
注意
ntdsapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 DsReplicaUpdateRefs 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 支援的最低伺服器 | Windows Server 2008 |
| 目標平臺 | 窗戶 |
| 標頭 | ntdsapi.h |
| 連結庫 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |