DS_REPL_NEIGHBORW_BLOB
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| oszNamingContext | DWORD | 4 | +0 | +0 | このレプリケーション状態データが対象とする名前付けコンテキストを格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。各名前付けコンテキストは独立してレプリケートされ、たとえ同じソースサーバーからレプリケートされる場合であっても、それぞれ異なるネイバーデータを持ちます。 |
| oszSourceDsaDN | DWORD | 4 | +4 | +4 | このレプリケーション状態データが対象とするソースサーバーに対応するディレクトリサービスエージェントの識別名を格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。ソースサーバーごとに異なるネイバーデータを持ちます。 |
| oszSourceDsaAddress | DWORD | 4 | +8 | +8 | ソースサーバーのトランスポート固有のネットワークアドレスを格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。つまり、RPC/IP レプリケーションの場合はディレクトリ名前サービス名、SMTP レプリケーションの場合は SMTP アドレスです。 |
| oszAsyncIntersiteTransportDN | DWORD | 4 | +12 | +12 | レプリケーションが実行されるトランスポートに対応する interSiteTransport オブジェクトの識別名を格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。RPC/IP レプリケーションの場合、このメンバーには NULL が格納されます。 |
| dwReplicaFlags | DWORD | 4 | +16 | +16 | レプリケーションデータの属性とオプションを指定するフラグのセットを格納します。0 または次のフラグの 1 つ以上の組み合わせを指定できます。 DS_REPL_NBR_WRITEABLE名前付けコンテキストのローカルコピーは書き込み可能です。 DS_REPL_NBR_SYNC_ON_STARTUP宛先サーバーの起動時に、このソースからのこの名前付けコンテキストのレプリケーションが試行されます。通常、これはサイト内のネイバーにのみ適用されます。 DS_REPL_NBR_DO_SCHEDULED_SYNCSスケジュールに従ってレプリケーションを実行します。この名前付けコンテキスト/ソースのスケジュールが「never」(空のスケジュール)でない限り、通常このフラグは設定されます。 DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORTサイト間メッセージングサービスを介して間接的にレプリケーションを実行します。このフラグは SMTP 経由でレプリケートする場合にのみ設定されます。サイト間 RPC/IP 経由でレプリケートする場合には設定されません。 DS_REPL_NBR_TWO_WAY_SYNC設定されている場合、受信レプリケーションの完了時に、宛先サーバーがソースサーバーに対して逆方向の同期を行うよう指示する必要があることを示します。この機能は、2 台のサーバーのうち一方だけがダイヤルアップ接続を開始できるダイヤルアップのシナリオで使用されます。たとえば、支社がダイヤルアップ ISP 接続を通じてインターネット経由で本社に接続するような、本社と支社の環境でこのオプションが使用されます。 DS_REPL_NBR_FULL_SYNC_IN_PROGRESS宛先サーバーがソースサーバーからの完全同期を実行しています。完全同期では、更新をフィルター処理するために更新を作成するベクター (DS_REPL_CURSORS) を使用しません。完全同期は通常のレプリケーションプロトコルの一部としては使用されません。 DS_REPL_NBR_FULL_SYNC_NEXT_PACKETソースからの最後のパケットが、宛先サーバーがまだ作成していないオブジェクトの変更を示していました。次に要求されるパケットでは、変更されたオブジェクトのすべての属性をパケットに格納するようソースサーバーに指示します。 DS_REPL_NBR_NEVER_SYNCEDこのソースからの同期が一度も正常に完了していません。 DS_REPL_NBR_COMPRESS_CHANGESこのソースから受信した変更は圧縮されます。通常、これはソースサーバーが別のサイトにある場合にのみ設定されます。 DS_REPL_NBR_NO_CHANGE_NOTIFICATIONSこのソースからは変更通知を受信しません。通常、これはソースサーバーが別のサイトにある場合にのみ設定されます。 |
| dwReserved | DWORD | 4 | +20 | +20 | 将来の使用のために予約済みです。 |
| uuidNamingContextObjGuid | GUID | 16 | +24 | +24 | pszNamingContext に対応する名前付けコンテキストの objectGuid を格納します。 |
| uuidSourceDsaObjGuid | GUID | 16 | +40 | +40 | pszSourceDsaDN に対応する nTDSDSA オブジェクトの objectGuid を格納します。 |
| uuidSourceDsaInvocationID | GUID | 16 | +56 | +56 | 最後のレプリケーション試行時点でソースサーバーが使用していた呼び出し識別子を格納します。 |
| uuidAsyncIntersiteTransportObjGuid | GUID | 16 | +72 | +72 | pszAsyncIntersiteTransportDN に対応するサイト間トランスポートオブジェクトの objectGuid を格納します。 |
| usnLastObjChangeSynced | LONGLONG | 8 | +88 | +88 | 最後に受信したオブジェクト更新の更新シーケンス番号を格納します。 |
| usnAttributeFilter | LONGLONG | 8 | +96 | +96 | 最後に完了した正常なレプリケーションサイクルの終了時点における usnLastObjChangeSynced の値を格納します。そのようなサイクルがない場合は 0 です。ソース側でこの値以下の更新シーケンス番号で最後に更新された属性は、すでに宛先で受信され適用されています。 |
| ftimeLastSyncSuccess | FILETIME | 8 | +104 | +104 | このソースからの最後の正常なレプリケーションサイクルが完了した日時を格納する FILETIME 構造体を格納します。レプリケーションサイクルが一度も完了していない場合、この構造体のすべてのメンバーは 0 になります。 |
| ftimeLastSyncAttempt | FILETIME | 8 | +112 | +112 | このソースからの最後のレプリケーション試行の日時を格納する FILETIME 構造体を格納します。レプリケーションが一度も試行されていない場合、この構造体のすべてのメンバーは 0 になります。 |
| dwLastSyncResult | DWORD | 4 | +120 | +120 | このソースからの最後のレプリケーション試行に関連する Windows エラーコードを格納します。最後の試行が成功した場合は ERROR_SUCCESS が格納されます。 |
| cNumConsecutiveSyncFailures | DWORD | 4 | +124 | +124 | 最後にレプリケーションが成功して以降、または過去に成功した試行がない場合はソースがネイバーとして追加されて以降に、このソースから行われたレプリケーション試行のうち失敗した回数を格納します。 |
公式ドキュメント
DS_REPL_NEIGHBORW_BLOB 構造体は、特定の名前付けコンテキストとソースサーバーの組み合わせに関する受信レプリケーションの状態データを格納します。この構造体は DS_REPL_NEIGHBOR 構造体に似ていますが、msDS-NCReplInboundNeighbors 属性のバイナリデータを取得する際に Lightweight Directory Access Protocol API の関数から取得されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FILETIME (x64 8 / x86 8 バイト)
typedef struct FILETIME {
DWORD dwLowDateTime;
DWORD dwHighDateTime;
} FILETIME;
// DS_REPL_NEIGHBORW_BLOB (x64 128 / x86 128 バイト)
typedef struct DS_REPL_NEIGHBORW_BLOB {
DWORD oszNamingContext;
DWORD oszSourceDsaDN;
DWORD oszSourceDsaAddress;
DWORD oszAsyncIntersiteTransportDN;
DWORD dwReplicaFlags;
DWORD dwReserved;
GUID uuidNamingContextObjGuid;
GUID uuidSourceDsaObjGuid;
GUID uuidSourceDsaInvocationID;
GUID uuidAsyncIntersiteTransportObjGuid;
LONGLONG usnLastObjChangeSynced;
LONGLONG usnAttributeFilter;
FILETIME ftimeLastSyncSuccess;
FILETIME ftimeLastSyncAttempt;
DWORD dwLastSyncResult;
DWORD cNumConsecutiveSyncFailures;
} DS_REPL_NEIGHBORW_BLOB;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
public uint dwLowDateTime;
public uint dwHighDateTime;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DS_REPL_NEIGHBORW_BLOB
{
public uint oszNamingContext;
public uint oszSourceDsaDN;
public uint oszSourceDsaAddress;
public uint oszAsyncIntersiteTransportDN;
public uint dwReplicaFlags;
public uint dwReserved;
public Guid uuidNamingContextObjGuid;
public Guid uuidSourceDsaObjGuid;
public Guid uuidSourceDsaInvocationID;
public Guid uuidAsyncIntersiteTransportObjGuid;
public long usnLastObjChangeSynced;
public long usnAttributeFilter;
public FILETIME ftimeLastSyncSuccess;
public FILETIME ftimeLastSyncAttempt;
public uint dwLastSyncResult;
public uint cNumConsecutiveSyncFailures;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
Public dwLowDateTime As UInteger
Public dwHighDateTime As UInteger
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DS_REPL_NEIGHBORW_BLOB
Public oszNamingContext As UInteger
Public oszSourceDsaDN As UInteger
Public oszSourceDsaAddress As UInteger
Public oszAsyncIntersiteTransportDN As UInteger
Public dwReplicaFlags As UInteger
Public dwReserved As UInteger
Public uuidNamingContextObjGuid As Guid
Public uuidSourceDsaObjGuid As Guid
Public uuidSourceDsaInvocationID As Guid
Public uuidAsyncIntersiteTransportObjGuid As Guid
Public usnLastObjChangeSynced As Long
Public usnAttributeFilter As Long
Public ftimeLastSyncSuccess As FILETIME
Public ftimeLastSyncAttempt As FILETIME
Public dwLastSyncResult As UInteger
Public cNumConsecutiveSyncFailures As UInteger
End Structureimport ctypes
from ctypes import wintypes
class FILETIME(ctypes.Structure):
_fields_ = [
("dwLowDateTime", wintypes.DWORD),
("dwHighDateTime", wintypes.DWORD),
]
class DS_REPL_NEIGHBORW_BLOB(ctypes.Structure):
_fields_ = [
("oszNamingContext", wintypes.DWORD),
("oszSourceDsaDN", wintypes.DWORD),
("oszSourceDsaAddress", wintypes.DWORD),
("oszAsyncIntersiteTransportDN", wintypes.DWORD),
("dwReplicaFlags", wintypes.DWORD),
("dwReserved", wintypes.DWORD),
("uuidNamingContextObjGuid", GUID),
("uuidSourceDsaObjGuid", GUID),
("uuidSourceDsaInvocationID", GUID),
("uuidAsyncIntersiteTransportObjGuid", GUID),
("usnLastObjChangeSynced", ctypes.c_longlong),
("usnAttributeFilter", ctypes.c_longlong),
("ftimeLastSyncSuccess", FILETIME),
("ftimeLastSyncAttempt", FILETIME),
("dwLastSyncResult", wintypes.DWORD),
("cNumConsecutiveSyncFailures", wintypes.DWORD),
]#[repr(C)]
pub struct FILETIME {
pub dwLowDateTime: u32,
pub dwHighDateTime: u32,
}
#[repr(C)]
pub struct DS_REPL_NEIGHBORW_BLOB {
pub oszNamingContext: u32,
pub oszSourceDsaDN: u32,
pub oszSourceDsaAddress: u32,
pub oszAsyncIntersiteTransportDN: u32,
pub dwReplicaFlags: u32,
pub dwReserved: u32,
pub uuidNamingContextObjGuid: GUID,
pub uuidSourceDsaObjGuid: GUID,
pub uuidSourceDsaInvocationID: GUID,
pub uuidAsyncIntersiteTransportObjGuid: GUID,
pub usnLastObjChangeSynced: i64,
pub usnAttributeFilter: i64,
pub ftimeLastSyncSuccess: FILETIME,
pub ftimeLastSyncAttempt: FILETIME,
pub dwLastSyncResult: u32,
pub cNumConsecutiveSyncFailures: u32,
}import "golang.org/x/sys/windows"
type FILETIME struct {
dwLowDateTime uint32
dwHighDateTime uint32
}
type DS_REPL_NEIGHBORW_BLOB struct {
oszNamingContext uint32
oszSourceDsaDN uint32
oszSourceDsaAddress uint32
oszAsyncIntersiteTransportDN uint32
dwReplicaFlags uint32
dwReserved uint32
uuidNamingContextObjGuid windows.GUID
uuidSourceDsaObjGuid windows.GUID
uuidSourceDsaInvocationID windows.GUID
uuidAsyncIntersiteTransportObjGuid windows.GUID
usnLastObjChangeSynced int64
usnAttributeFilter int64
ftimeLastSyncSuccess FILETIME
ftimeLastSyncAttempt FILETIME
dwLastSyncResult uint32
cNumConsecutiveSyncFailures uint32
}type
FILETIME = record
dwLowDateTime: DWORD;
dwHighDateTime: DWORD;
end;
DS_REPL_NEIGHBORW_BLOB = record
oszNamingContext: DWORD;
oszSourceDsaDN: DWORD;
oszSourceDsaAddress: DWORD;
oszAsyncIntersiteTransportDN: DWORD;
dwReplicaFlags: DWORD;
dwReserved: DWORD;
uuidNamingContextObjGuid: TGUID;
uuidSourceDsaObjGuid: TGUID;
uuidSourceDsaInvocationID: TGUID;
uuidAsyncIntersiteTransportObjGuid: TGUID;
usnLastObjChangeSynced: Int64;
usnAttributeFilter: Int64;
ftimeLastSyncSuccess: FILETIME;
ftimeLastSyncAttempt: FILETIME;
dwLastSyncResult: DWORD;
cNumConsecutiveSyncFailures: DWORD;
end;const FILETIME = extern struct {
dwLowDateTime: u32,
dwHighDateTime: u32,
};
const DS_REPL_NEIGHBORW_BLOB = extern struct {
oszNamingContext: u32,
oszSourceDsaDN: u32,
oszSourceDsaAddress: u32,
oszAsyncIntersiteTransportDN: u32,
dwReplicaFlags: u32,
dwReserved: u32,
uuidNamingContextObjGuid: GUID,
uuidSourceDsaObjGuid: GUID,
uuidSourceDsaInvocationID: GUID,
uuidAsyncIntersiteTransportObjGuid: GUID,
usnLastObjChangeSynced: i64,
usnAttributeFilter: i64,
ftimeLastSyncSuccess: FILETIME,
ftimeLastSyncAttempt: FILETIME,
dwLastSyncResult: u32,
cNumConsecutiveSyncFailures: u32,
};type
FILETIME {.bycopy.} = object
dwLowDateTime: uint32
dwHighDateTime: uint32
DS_REPL_NEIGHBORW_BLOB {.bycopy.} = object
oszNamingContext: uint32
oszSourceDsaDN: uint32
oszSourceDsaAddress: uint32
oszAsyncIntersiteTransportDN: uint32
dwReplicaFlags: uint32
dwReserved: uint32
uuidNamingContextObjGuid: GUID
uuidSourceDsaObjGuid: GUID
uuidSourceDsaInvocationID: GUID
uuidAsyncIntersiteTransportObjGuid: GUID
usnLastObjChangeSynced: int64
usnAttributeFilter: int64
ftimeLastSyncSuccess: FILETIME
ftimeLastSyncAttempt: FILETIME
dwLastSyncResult: uint32
cNumConsecutiveSyncFailures: uint32struct FILETIME
{
uint dwLowDateTime;
uint dwHighDateTime;
}
struct DS_REPL_NEIGHBORW_BLOB
{
uint oszNamingContext;
uint oszSourceDsaDN;
uint oszSourceDsaAddress;
uint oszAsyncIntersiteTransportDN;
uint dwReplicaFlags;
uint dwReserved;
GUID uuidNamingContextObjGuid;
GUID uuidSourceDsaObjGuid;
GUID uuidSourceDsaInvocationID;
GUID uuidAsyncIntersiteTransportObjGuid;
long usnLastObjChangeSynced;
long usnAttributeFilter;
FILETIME ftimeLastSyncSuccess;
FILETIME ftimeLastSyncAttempt;
uint dwLastSyncResult;
uint cNumConsecutiveSyncFailures;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DS_REPL_NEIGHBORW_BLOB サイズ: 128 バイト(x64)
dim st, 32 ; 4byte整数×32(構造体サイズ 128 / 4 切り上げ)
; oszNamingContext : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; oszSourceDsaDN : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; oszSourceDsaAddress : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; oszAsyncIntersiteTransportDN : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; dwReplicaFlags : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwReserved : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; uuidNamingContextObjGuid : GUID (+24, 16byte) varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; uuidSourceDsaObjGuid : GUID (+40, 16byte) varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; uuidSourceDsaInvocationID : GUID (+56, 16byte) varptr(st)+56 を基点に操作(16byte:入れ子/配列)
; uuidAsyncIntersiteTransportObjGuid : GUID (+72, 16byte) varptr(st)+72 を基点に操作(16byte:入れ子/配列)
; usnLastObjChangeSynced : LONGLONG (+88, 8byte) qpoke st,88,値 / qpeek(st,88) ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; usnAttributeFilter : LONGLONG (+96, 8byte) qpoke st,96,値 / qpeek(st,96) ※IronHSPのみ。3.7/3.8は lpoke st,96,下位 : lpoke st,100,上位
; ftimeLastSyncSuccess : FILETIME (+104, 8byte) varptr(st)+104 を基点に操作(8byte:入れ子/配列)
; ftimeLastSyncAttempt : FILETIME (+112, 8byte) varptr(st)+112 を基点に操作(8byte:入れ子/配列)
; dwLastSyncResult : DWORD (+120, 4byte) st.30 = 値 / 値 = st.30 (lpoke/lpeek も可)
; cNumConsecutiveSyncFailures : DWORD (+124, 4byte) st.31 = 値 / 値 = st.31 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global FILETIME
#field int dwLowDateTime
#field int dwHighDateTime
#endstruct
#defstruct global DS_REPL_NEIGHBORW_BLOB
#field int oszNamingContext
#field int oszSourceDsaDN
#field int oszSourceDsaAddress
#field int oszAsyncIntersiteTransportDN
#field int dwReplicaFlags
#field int dwReserved
#field GUID uuidNamingContextObjGuid
#field GUID uuidSourceDsaObjGuid
#field GUID uuidSourceDsaInvocationID
#field GUID uuidAsyncIntersiteTransportObjGuid
#field int64 usnLastObjChangeSynced
#field int64 usnAttributeFilter
#field FILETIME ftimeLastSyncSuccess
#field FILETIME ftimeLastSyncAttempt
#field int dwLastSyncResult
#field int cNumConsecutiveSyncFailures
#endstruct
stdim st, DS_REPL_NEIGHBORW_BLOB ; NSTRUCT 変数を確保
st->oszNamingContext = 100
mes "oszNamingContext=" + st->oszNamingContext