Win32 API 日本語リファレンス
ホームNetworking.ActiveDirectory › DS_REPL_NEIGHBORW_BLOB

DS_REPL_NEIGHBORW_BLOB

構造体
サイズx64: 128 バイト / x86: 128 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
oszNamingContextDWORD4+0+0このレプリケーション状態データが対象とする名前付けコンテキストを格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。各名前付けコンテキストは独立してレプリケートされ、たとえ同じソースサーバーからレプリケートされる場合であっても、それぞれ異なるネイバーデータを持ちます。
oszSourceDsaDNDWORD4+4+4このレプリケーション状態データが対象とするソースサーバーに対応するディレクトリサービスエージェントの識別名を格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。ソースサーバーごとに異なるネイバーデータを持ちます。
oszSourceDsaAddressDWORD4+8+8ソースサーバーのトランスポート固有のネットワークアドレスを格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。つまり、RPC/IP レプリケーションの場合はディレクトリ名前サービス名、SMTP レプリケーションの場合は SMTP アドレスです。
oszAsyncIntersiteTransportDNDWORD4+12+12レプリケーションが実行されるトランスポートに対応する interSiteTransport オブジェクトの識別名を格納する、null で終わる Unicode 文字列への、この構造体のアドレスからのオフセットをバイト単位で格納します。RPC/IP レプリケーションの場合、このメンバーには NULL が格納されます。
dwReplicaFlagsDWORD4+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

このソースからは変更通知を受信しません。通常、これはソースサーバーが別のサイトにある場合にのみ設定されます。

dwReservedDWORD4+20+20将来の使用のために予約済みです。
uuidNamingContextObjGuidGUID16+24+24pszNamingContext に対応する名前付けコンテキストの objectGuid を格納します。
uuidSourceDsaObjGuidGUID16+40+40pszSourceDsaDN に対応する nTDSDSA オブジェクトの objectGuid を格納します。
uuidSourceDsaInvocationIDGUID16+56+56最後のレプリケーション試行時点でソースサーバーが使用していた呼び出し識別子を格納します。
uuidAsyncIntersiteTransportObjGuidGUID16+72+72pszAsyncIntersiteTransportDN に対応するサイト間トランスポートオブジェクトの objectGuid を格納します。
usnLastObjChangeSyncedLONGLONG8+88+88最後に受信したオブジェクト更新の更新シーケンス番号を格納します。
usnAttributeFilterLONGLONG8+96+96最後に完了した正常なレプリケーションサイクルの終了時点における usnLastObjChangeSynced の値を格納します。そのようなサイクルがない場合は 0 です。ソース側でこの値以下の更新シーケンス番号で最後に更新された属性は、すでに宛先で受信され適用されています。
ftimeLastSyncSuccessFILETIME8+104+104このソースからの最後の正常なレプリケーションサイクルが完了した日時を格納する FILETIME 構造体を格納します。レプリケーションサイクルが一度も完了していない場合、この構造体のすべてのメンバーは 0 になります。
ftimeLastSyncAttemptFILETIME8+112+112このソースからの最後のレプリケーション試行の日時を格納する FILETIME 構造体を格納します。レプリケーションが一度も試行されていない場合、この構造体のすべてのメンバーは 0 になります。
dwLastSyncResultDWORD4+120+120このソースからの最後のレプリケーション試行に関連する Windows エラーコードを格納します。最後の試行が成功した場合は ERROR_SUCCESS が格納されます。
cNumConsecutiveSyncFailuresDWORD4+124+124最後にレプリケーションが成功して以降、または過去に成功した試行がない場合はソースがネイバーとして追加されて以降に、このソースから行われたレプリケーション試行のうち失敗した回数を格納します。

公式ドキュメント

DS_REPL_NEIGHBORW_BLOB 構造体は、特定の名前付けコンテキストとソースサーバーの組み合わせに関する受信レプリケーションの状態データを格納します。この構造体は DS_REPL_NEIGHBOR 構造体に似ていますが、msDS-NCReplInboundNeighbors 属性のバイナリデータを取得する際に Lightweight Directory Access Protocol API の関数から取得されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint32
struct 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