DS_REPL_NEIGHBORW 構造体 (ntdsapi.h)

[アーティクル]
02/29/2024

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

レプリケーションが実行されるトランスポートに対応する interSiteTransport オブジェクトの識別名を含む null で終わる文字列へのポインター。このメンバーには、RPC/IP レプリケーションの NULL が 含まれています。

dwReplicaFlags

レプリケーションデータの属性とオプションを指定するフラグのセットが含まれます。これは、0 または次のフラグの 1 つ以上の組み合わせにすることができます。

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))

設定されている場合、は、受信レプリケーションが完了したときに、移行先サーバーがソースサーバーに逆方向の同期を指示する必要があることを示します。この機能は、ダイアルアップを使用する場合で、2 つのサーバーの内 1 つだけしかダイアルアップ接続を開始できないときに使用されます。たとえば、このオプションは、企業の本社と支社のオフィスで、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 構造体が含まれています。レプリケーションサイクルが完了したことがない場合、この構造体のすべてのメンバーは 0 になります。

ftimeLastSyncAttempt

このソースからの最後のレプリケーション試行の日時を含む FILETIME 構造体が含まれます。レプリケーションが試行されていない場合、この構造体のすべてのメンバーは 0 になります。

dwLastSyncResult

このソースからの最後のレプリケーション試行に関連付けられているエラーコードが含まれています。最後の試行が成功した場合の ERROR_SUCCESS を格納します。

cNumConsecutiveSyncFailures

前回の正常なレプリケーション試行以降、または以前の試行が成功しなかった場合に、ソースが近隣ノードとして追加されてからの、このソースからの失敗したレプリケーション試行の数が含まれます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	ntdsapi.h

こちらもご覧ください

次の方法で共有