共用方式為

DS_REPL_NEIGHBORW 結構 (ntdsapi.h)

  • 發行項

DS_REPL_NEIGHBOR結構包含特定命名內容和來源伺服器配對的輸入復寫狀態數據，如 DsReplicaGetInfo 和 DsReplicaGetInfo2 函式所傳回。

語法

typedef struct _DS_REPL_NEIGHBORW {
  LPWSTR   pszNamingContext;
  LPWSTR   pszSourceDsaDN;
  LPWSTR   pszSourceDsaAddress;
  LPWSTR   pszAsyncIntersiteTransportDN;
  DWORD    dwReplicaFlags;
  DWORD    dwReserved;
  UUID     uuidNamingContextObjGuid;
  UUID     uuidSourceDsaObjGuid;
  UUID     uuidSourceDsaInvocationID;
  UUID     uuidAsyncIntersiteTransportObjGuid;
  USN      usnLastObjChangeSynced;
  USN      usnAttributeFilter;
  FILETIME ftimeLastSyncSuccess;
  FILETIME ftimeLastSyncAttempt;
  DWORD    dwLastSyncResult;
  DWORD    cNumConsecutiveSyncFailures;
} DS_REPL_NEIGHBORW;

成員

pszNamingContext

Null 終止字串的指標，其中包含此複寫狀態數據所屬的命名內容。 每個命名內容都會獨立複寫，而且具有不同的相關聯鄰近數據，即使命名內容是從相同的來源伺服器複寫也一樣。

pszSourceDsaDN

Null 終止字串的指標，其中包含對應至這個復寫狀態數據所在來源伺服器的目錄服務代理程式辨別名稱。 每個來源伺服器都有不同的關聯鄰近數據。

pszSourceDsaAddress

Null 終止字串的指標，其中包含來源伺服器的傳輸特定網路位址。 也就是說，RPC/IP 複寫的目錄名稱服務名稱，或 SMTP 複寫的 SMTP 位址。

pszAsyncIntersiteTransportDN

Null 終止字串的指標，其中包含對應至執行複寫之傳輸的 InterSiteTransport 物件的辨別名稱。 此成員包含 RPC/IP 複寫的 NULL 。

dwReplicaFlags

包含一組旗標，指定複寫數據的屬性和選項。 這可以是零或下列一或多個旗標的組合。

DS_REPL_NBR_WRITEABLE (16 (0x10) )

此命名內容的本機複本是可寫入的。

DS_REPL_NBR_SYNC_ON_STARTUP (32 (0x20) )

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

DS_REPL_NBR_DO_SCHEDULED_SYNCS (64 (0x40) )

根據排程來執行複寫。 除非此命名內容/來源的排程是 “never”，也就是空的排程，否則通常會設定此旗標。

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT (128 (0x80) )

透過站台間訊息服務來間接執行複寫。 只有透過 SMTP 複寫時，才會設定這個旗標。 透過站台間的 RPC/IP 複寫時，不會設定這個旗標。

DS_REPL_NBR_TWO_WAY_SYNC (512 (0x200) )

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

DS_REPL_NBR_RETURN_OBJECT_PARENTS (2048 (0x800) )

這個鄰居所處的狀態是要在子物件之前傳回父物件； 當它在父物件之前收到子物件之後，會進入這個狀態。

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS (65536 (0x10000) )

目的伺服器會從來源伺服器執行完整的同步處理； 完整同步處理不會使用建立更新的向量， (DS_REPL_CURSORS) 篩選更新。 正常的複寫通訊協定中不會使用完整的同步處理。

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET (131072 (0x20000) )

來源的最後一個封包表示尚未建立目的地伺服器的物件修改。 要要求的下一個封包會指示來源伺服器將修改物件的所有屬性放入封包中。

DS_REPL_NBR_NEVER_SYNCED (2097152 (0x200000) )

從來沒有從這個來源中順利完成同步處理。

DS_REPL_NBR_PREEMPTED (16777216 (0x1000000) )

復寫引擎已暫時停止處理此鄰近，以便針對此分割區或另一個分割區服務另一個較高優先順序的芳鄰。 複寫引擎在完成較高優先權的工作之後，會繼續處理這個鄰居。

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS (67108864 (0x4000000) )

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

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC (134217728 (0x8000000) )

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

DS_REPL_NBR_COMPRESS_CHANGES (268435456 (0x10000000) )

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

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS (536870912 (0x20000000) )

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

DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET (1073741824 (0x40000000) )

這個鄰居所處的狀態是要重建此複本的內容，因為部分屬性集已經有變更。

dwReserved

保留供未來使用。

uuidNamingContextObjGuid

包含對應至 pszNamingContext 之命名內容的 objectGuid。

uuidSourceDsaObjGuid

包含對應至 pszSourceDsaDN 之 nTDSDSA 物件的 objectGuid。

uuidSourceDsaInvocationID

包含來源伺服器在上次復寫嘗試時所使用的調用標識碼。

uuidAsyncIntersiteTransportObjGuid

包含對應至 pszAsyncIntersiteTransportDN 之月臺間傳輸物件的 objectGuid。

usnLastObjChangeSynced

包含上次收到之物件更新的更新序號。

usnAttributeFilter

包含最後一個完成、成功復寫周期結尾的 usnLastObjChangeSynced 值，如果沒有，則包含 0。 來源的屬性上次更新的更新序號小於或等於此值已由目的地接收並套用。

ftimeLastSyncSuccess

包含 FILETIME 結構，其中包含從這個來源完成上次成功復寫週期的日期和時間。 如果復寫周期從未完成，此結構的所有成員都是零。

ftimeLastSyncAttempt

包含 FILETIME 結構，其中包含此來源上次複寫嘗試的日期和時間。 如果從未嘗試複寫，此結構的所有成員都是零。

dwLastSyncResult

包含與此來源上次復寫嘗試相關聯的錯誤碼。 如果上次嘗試成功，則包含 ERROR_SUCCESS 。

cNumConsecutiveSyncFailures

包含自上次成功複寫嘗試后，從這個來源嘗試失敗的復寫嘗試次數，或因為來源新增為鄰近，如果沒有先前的嘗試成功，則為鄰近。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
標頭 ntdsapi.h

另請參閱

DS_REPL_NEIGHBORS

DsReplicaGetInfo

DsReplicaGetInfo2

FILETIME