DS_REPL_OPW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| ftimeEnqueued | FILETIME | 8 | +0 | +0 | この操作がキューに追加された日時を格納する FILETIME 構造体が格納されます。 |
| ulSerialNumber | DWORD | 4 | +8 | +8 | 操作の識別子が格納されます。この値は、各コンピューターのスタートアップルーチン内で一意です。コンピューターが再起動されると、この識別子は一意ではなくなります。 |
| ulPriority | DWORD | 4 | +12 | +12 | この操作の優先度の値が格納されます。優先度の値が大きいタスクほど先に実行されます。優先度は、操作の種類とそのパラメーターに基づいてサーバーによって計算されます。 |
| OpType | DS_REPL_OP_TYPE | 4 | +16 | +16 | この構造体が表す操作の種類を示す DS_REPL_OP_TYPE 値のいずれかが格納されます。 |
| ulOptions | DWORD | 4 | +20 | +20 | 0 個以上のビットで、その解釈は OpType によって異なります。DS_REPL_OP_TYPE_SYNC の場合、これらのビットは DS_REPSYNC_* として解釈されます。ADD、DELETE、MODIFY、UPDATE_REFS では、それぞれ DS_REPADD_*、DS_REPDEL_*、DS_REPMOD_*、DS_REPUPD_* を使用します。これらのビットの詳細と説明については、 DsReplicaSync、 DsReplicaAdd、 DsReplicaDel、 DsReplicaModify、および DsReplicaUpdateRefs を参照してください。 操作に関する追加情報を提供するフラグのセットが格納されます。このメンバーの内容は、OpType メンバーの内容によって決まります。 DS_REPL_OP_TYPE_SYNCDsReplicaSync の Options パラメーター用に定義されている DS_REPSYNC_* 値の 0 個、または 1 個以上の組み合わせが格納されます。 DS_REPL_OP_TYPE_ADDDsReplicaAdd の Options パラメーター用に定義されている DS_REPADD_* 値の 0 個、または 1 個以上の組み合わせが格納されます。 DS_REPL_OP_TYPE_DELETEDsReplicaDel の Options パラメーター用に定義されている DS_REPDEL_* 値の 0 個、または 1 個以上の組み合わせが格納されます。 DS_REPL_OP_TYPE_MODIFYDsReplicaModify の Options パラメーター用に定義されている DS_REPMOD_* 値の 0 個、または 1 個以上の組み合わせが格納されます。 DS_REPL_OP_TYPE_UPDATE_REFSDsReplicaUpdateRefs の Options パラメーター用に定義されている DS_REPSUPD_* 値の 0 個、または 1 個以上の組み合わせが格納されます。 |
| pszNamingContext | LPWSTR | 8/4 | +24 | +24 | この操作に関連付けられている名前付けコンテキストの識別名を格納する、NULL で終わる文字列へのポインターです。たとえば、DS_REPL_OP_TYPE_SYNC の場合は同期対象の名前付けコンテキストです。 |
| pszDsaDN | LPWSTR | 8/4 | +32 | +28 | この操作に対応するリモートサーバーに関連付けられたディレクトリシステムエージェントオブジェクトの識別名を格納する、NULL で終わる文字列へのポインターです。たとえば、DS_REPL_OP_TYPE_SYNC の場合は変更の要求先となるサーバーです。NULL の場合があります。 |
| pszDsaAddress | LPWSTR | 8/4 | +40 | +32 | この操作に関連付けられたリモートサーバーの、トランスポート固有のネットワークアドレスを格納する、NULL で終わる文字列へのポインターです。たとえば、DS_REPL_OP_TYPE_SYNC の場合は変更の要求先となるサーバーの DNS アドレスまたは SMTP アドレスです。NULL の場合があります。 |
| uuidNamingContextObjGuid | GUID | 16 | +48 | +36 | pszNamingContext で識別される名前付けコンテキストの objectGuid が格納されます。 |
| uuidDsaObjGuid | GUID | 16 | +64 | +52 | pszDsaDN で識別されるディレクトリシステムエージェントオブジェクトの objectGuid が格納されます。 |
公式ドキュメント
DS_REPL_OP 構造体は、 DsReplicaGetInfo 関数または DsReplicaGetInfo2 関数によって返される、現在実行中または実行待ちのレプリケーションタスクを表します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FILETIME (x64 8 / x86 8 バイト)
typedef struct FILETIME {
DWORD dwLowDateTime;
DWORD dwHighDateTime;
} FILETIME;
// DS_REPL_OPW (x64 80 / x86 68 バイト)
typedef struct DS_REPL_OPW {
FILETIME ftimeEnqueued;
DWORD ulSerialNumber;
DWORD ulPriority;
DS_REPL_OP_TYPE OpType;
DWORD ulOptions;
LPWSTR pszNamingContext;
LPWSTR pszDsaDN;
LPWSTR pszDsaAddress;
GUID uuidNamingContextObjGuid;
GUID uuidDsaObjGuid;
} DS_REPL_OPW;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_OPW
{
public FILETIME ftimeEnqueued;
public uint ulSerialNumber;
public uint ulPriority;
public int OpType;
public uint ulOptions;
public IntPtr pszNamingContext;
public IntPtr pszDsaDN;
public IntPtr pszDsaAddress;
public Guid uuidNamingContextObjGuid;
public Guid uuidDsaObjGuid;
}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_OPW
Public ftimeEnqueued As FILETIME
Public ulSerialNumber As UInteger
Public ulPriority As UInteger
Public OpType As Integer
Public ulOptions As UInteger
Public pszNamingContext As IntPtr
Public pszDsaDN As IntPtr
Public pszDsaAddress As IntPtr
Public uuidNamingContextObjGuid As Guid
Public uuidDsaObjGuid As Guid
End Structureimport ctypes
from ctypes import wintypes
class FILETIME(ctypes.Structure):
_fields_ = [
("dwLowDateTime", wintypes.DWORD),
("dwHighDateTime", wintypes.DWORD),
]
class DS_REPL_OPW(ctypes.Structure):
_fields_ = [
("ftimeEnqueued", FILETIME),
("ulSerialNumber", wintypes.DWORD),
("ulPriority", wintypes.DWORD),
("OpType", ctypes.c_int),
("ulOptions", wintypes.DWORD),
("pszNamingContext", ctypes.c_void_p),
("pszDsaDN", ctypes.c_void_p),
("pszDsaAddress", ctypes.c_void_p),
("uuidNamingContextObjGuid", GUID),
("uuidDsaObjGuid", GUID),
]#[repr(C)]
pub struct FILETIME {
pub dwLowDateTime: u32,
pub dwHighDateTime: u32,
}
#[repr(C)]
pub struct DS_REPL_OPW {
pub ftimeEnqueued: FILETIME,
pub ulSerialNumber: u32,
pub ulPriority: u32,
pub OpType: i32,
pub ulOptions: u32,
pub pszNamingContext: *mut core::ffi::c_void,
pub pszDsaDN: *mut core::ffi::c_void,
pub pszDsaAddress: *mut core::ffi::c_void,
pub uuidNamingContextObjGuid: GUID,
pub uuidDsaObjGuid: GUID,
}import "golang.org/x/sys/windows"
type FILETIME struct {
dwLowDateTime uint32
dwHighDateTime uint32
}
type DS_REPL_OPW struct {
ftimeEnqueued FILETIME
ulSerialNumber uint32
ulPriority uint32
OpType int32
ulOptions uint32
pszNamingContext uintptr
pszDsaDN uintptr
pszDsaAddress uintptr
uuidNamingContextObjGuid windows.GUID
uuidDsaObjGuid windows.GUID
}type
FILETIME = record
dwLowDateTime: DWORD;
dwHighDateTime: DWORD;
end;
DS_REPL_OPW = record
ftimeEnqueued: FILETIME;
ulSerialNumber: DWORD;
ulPriority: DWORD;
OpType: Integer;
ulOptions: DWORD;
pszNamingContext: Pointer;
pszDsaDN: Pointer;
pszDsaAddress: Pointer;
uuidNamingContextObjGuid: TGUID;
uuidDsaObjGuid: TGUID;
end;const FILETIME = extern struct {
dwLowDateTime: u32,
dwHighDateTime: u32,
};
const DS_REPL_OPW = extern struct {
ftimeEnqueued: FILETIME,
ulSerialNumber: u32,
ulPriority: u32,
OpType: i32,
ulOptions: u32,
pszNamingContext: ?*anyopaque,
pszDsaDN: ?*anyopaque,
pszDsaAddress: ?*anyopaque,
uuidNamingContextObjGuid: GUID,
uuidDsaObjGuid: GUID,
};type
FILETIME {.bycopy.} = object
dwLowDateTime: uint32
dwHighDateTime: uint32
DS_REPL_OPW {.bycopy.} = object
ftimeEnqueued: FILETIME
ulSerialNumber: uint32
ulPriority: uint32
OpType: int32
ulOptions: uint32
pszNamingContext: pointer
pszDsaDN: pointer
pszDsaAddress: pointer
uuidNamingContextObjGuid: GUID
uuidDsaObjGuid: GUIDstruct FILETIME
{
uint dwLowDateTime;
uint dwHighDateTime;
}
struct DS_REPL_OPW
{
FILETIME ftimeEnqueued;
uint ulSerialNumber;
uint ulPriority;
int OpType;
uint ulOptions;
void* pszNamingContext;
void* pszDsaDN;
void* pszDsaAddress;
GUID uuidNamingContextObjGuid;
GUID uuidDsaObjGuid;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DS_REPL_OPW サイズ: 68 バイト(x86)
dim st, 17 ; 4byte整数×17(構造体サイズ 68 / 4 切り上げ)
; ftimeEnqueued : FILETIME (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; ulSerialNumber : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ulPriority : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; OpType : DS_REPL_OP_TYPE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ulOptions : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pszNamingContext : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pszDsaDN : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; pszDsaAddress : LPWSTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; uuidNamingContextObjGuid : GUID (+36, 16byte) varptr(st)+36 を基点に操作(16byte:入れ子/配列)
; uuidDsaObjGuid : GUID (+52, 16byte) varptr(st)+52 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DS_REPL_OPW サイズ: 80 バイト(x64)
dim st, 20 ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; ftimeEnqueued : FILETIME (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; ulSerialNumber : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ulPriority : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; OpType : DS_REPL_OP_TYPE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ulOptions : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pszNamingContext : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pszDsaDN : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pszDsaAddress : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; uuidNamingContextObjGuid : GUID (+48, 16byte) varptr(st)+48 を基点に操作(16byte:入れ子/配列)
; uuidDsaObjGuid : GUID (+64, 16byte) varptr(st)+64 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
#field int dwLowDateTime
#field int dwHighDateTime
#endstruct
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global DS_REPL_OPW
#field FILETIME ftimeEnqueued
#field int ulSerialNumber
#field int ulPriority
#field int OpType
#field int ulOptions
#field intptr pszNamingContext
#field intptr pszDsaDN
#field intptr pszDsaAddress
#field GUID uuidNamingContextObjGuid
#field GUID uuidDsaObjGuid
#endstruct
stdim st, DS_REPL_OPW ; NSTRUCT 変数を確保
st->ulSerialNumber = 100
mes "ulSerialNumber=" + st->ulSerialNumber