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

DS_REPL_KCC_DSA_FAILUREW_BLOB

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 36 バイト / x86: 36 バイト

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

フィールド

フィールド型サイズx64x86説明
oszDsaDNDWORD4+0+0この構造体のアドレスから、ソースサーバーに対応するディレクトリ内のディレクトリシステムエージェントオブジェクトの識別名を格納する null 終端文字列までのオフセットをバイト単位で格納します。
uuidDsaObjGuidGUID16+4+4oszDsaDN メンバーが表すディレクトリシステムエージェントオブジェクトの objectGuid を格納します。
ftimeFirstFailureFILETIME8+20+20

FILETIME 構造体を格納します。その内容は、要求されたバイナリレプリケーションデータによって異なります。

msDS-ReplConnectionFailures

ソースサーバーからのレプリケーションで最初の失敗が発生した日時を格納します。

msDS-ReplLinkFailures

最後に成功したレプリケーションの日時を格納します。

cNumFailuresDWORD4+28+28最後に成功したレプリケーション以降に連続して発生した失敗の回数を格納します。
dwLastResultDWORD4+32+32直近の失敗に関連付けられたエラーコードを格納します。特定のエラーが利用できない場合は ERROR_SUCCESS になります。

公式ドキュメント

DS_REPL_KCC_DSA_FAILUREW_BLOB 構造体は、特定の受信レプリケーションパートナーに関するレプリケーション状態データを格納します。この状態データは Knowledge Consistency Checker (KCC) によって収集され、到達できないサーバーに対処するために代替のレプリケーション経路を追加すべき時期を判断するために使用されます。 この構造体は DS_REPL_KCC_DSA_FAILURE 構造体に似ていますが、msDS-ReplConnectionFailures 属性または msDS-ReplLinkFailures 属性のバイナリデータを取得する際に 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_KCC_DSA_FAILUREW_BLOB  (x64 36 / x86 36 バイト)
typedef struct DS_REPL_KCC_DSA_FAILUREW_BLOB {
    DWORD oszDsaDN;
    GUID uuidDsaObjGuid;
    FILETIME ftimeFirstFailure;
    DWORD cNumFailures;
    DWORD dwLastResult;
} DS_REPL_KCC_DSA_FAILUREW_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_KCC_DSA_FAILUREW_BLOB
{
    public uint oszDsaDN;
    public Guid uuidDsaObjGuid;
    public FILETIME ftimeFirstFailure;
    public uint cNumFailures;
    public uint dwLastResult;
}
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_KCC_DSA_FAILUREW_BLOB
    Public oszDsaDN As UInteger
    Public uuidDsaObjGuid As Guid
    Public ftimeFirstFailure As FILETIME
    Public cNumFailures As UInteger
    Public dwLastResult As UInteger
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class DS_REPL_KCC_DSA_FAILUREW_BLOB(ctypes.Structure):
    _fields_ = [
        ("oszDsaDN", wintypes.DWORD),
        ("uuidDsaObjGuid", GUID),
        ("ftimeFirstFailure", FILETIME),
        ("cNumFailures", wintypes.DWORD),
        ("dwLastResult", wintypes.DWORD),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct DS_REPL_KCC_DSA_FAILUREW_BLOB {
    pub oszDsaDN: u32,
    pub uuidDsaObjGuid: GUID,
    pub ftimeFirstFailure: FILETIME,
    pub cNumFailures: u32,
    pub dwLastResult: u32,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type DS_REPL_KCC_DSA_FAILUREW_BLOB struct {
	oszDsaDN uint32
	uuidDsaObjGuid windows.GUID
	ftimeFirstFailure FILETIME
	cNumFailures uint32
	dwLastResult uint32
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  DS_REPL_KCC_DSA_FAILUREW_BLOB = record
    oszDsaDN: DWORD;
    uuidDsaObjGuid: TGUID;
    ftimeFirstFailure: FILETIME;
    cNumFailures: DWORD;
    dwLastResult: DWORD;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const DS_REPL_KCC_DSA_FAILUREW_BLOB = extern struct {
    oszDsaDN: u32,
    uuidDsaObjGuid: GUID,
    ftimeFirstFailure: FILETIME,
    cNumFailures: u32,
    dwLastResult: u32,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  DS_REPL_KCC_DSA_FAILUREW_BLOB {.bycopy.} = object
    oszDsaDN: uint32
    uuidDsaObjGuid: GUID
    ftimeFirstFailure: FILETIME
    cNumFailures: uint32
    dwLastResult: uint32
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct DS_REPL_KCC_DSA_FAILUREW_BLOB
{
    uint oszDsaDN;
    GUID uuidDsaObjGuid;
    FILETIME ftimeFirstFailure;
    uint cNumFailures;
    uint dwLastResult;
}

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_KCC_DSA_FAILUREW_BLOB サイズ: 36 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; oszDsaDN : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; uuidDsaObjGuid : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; ftimeFirstFailure : FILETIME (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; cNumFailures : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwLastResult : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (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_KCC_DSA_FAILUREW_BLOB
    #field int oszDsaDN
    #field GUID uuidDsaObjGuid
    #field FILETIME ftimeFirstFailure
    #field int cNumFailures
    #field int dwLastResult
#endstruct

stdim st, DS_REPL_KCC_DSA_FAILUREW_BLOB        ; NSTRUCT 変数を確保
st->oszDsaDN = 100
mes "oszDsaDN=" + st->oszDsaDN