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

DS_REPL_KCC_DSA_FAILUREW

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

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

フィールド

フィールドサイズx64x86説明
pszDsaDNLPWSTR8/4+0+0ソース サーバーに対応する、ディレクトリ内のディレクトリ システム エージェント オブジェクトの識別名を格納する、null で終わる文字列へのポインターです。
uuidDsaObjGuidGUID16+8+4pszDsaDN メンバーが表すディレクトリ システム エージェント オブジェクトの objectGuid を格納します。
ftimeFirstFailureFILETIME8+24+20

FILETIME 構造体を格納します。その内容は、DsReplicaGetInfo 関数または DsReplicaGetInfo2 関数を呼び出したときに InfoType パラメーターに渡した値によって異なります。

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

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

DS_REPL_INFO_KCC_DSA_LINK_FAILURES

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

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

公式ドキュメント

DS_REPL_KCC_DSA_FAILURE 構造体は、 DsReplicaGetInfo 関数および DsReplicaGetInfo2 関数によって返される、特定の受信レプリケーション パートナーに関するレプリケーション状態データを格納します。この状態データは Knowledge Consistency Checker (KCC) によって収集され、到達できないサーバーを考慮して代替のレプリケーション経路を追加する必要があるかどうかを判断するために使用されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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  (x64 40 / x86 36 バイト)
typedef struct DS_REPL_KCC_DSA_FAILUREW {
    LPWSTR pszDsaDN;
    GUID uuidDsaObjGuid;
    FILETIME ftimeFirstFailure;
    DWORD cNumFailures;
    DWORD dwLastResult;
} DS_REPL_KCC_DSA_FAILUREW;
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
{
    public IntPtr pszDsaDN;
    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
    Public pszDsaDN As IntPtr
    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(ctypes.Structure):
    _fields_ = [
        ("pszDsaDN", ctypes.c_void_p),
        ("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 {
    pub pszDsaDN: *mut core::ffi::c_void,
    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 struct {
	pszDsaDN uintptr
	uuidDsaObjGuid windows.GUID
	ftimeFirstFailure FILETIME
	cNumFailures uint32
	dwLastResult uint32
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

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

const DS_REPL_KCC_DSA_FAILUREW = extern struct {
    pszDsaDN: ?*anyopaque,
    uuidDsaObjGuid: GUID,
    ftimeFirstFailure: FILETIME,
    cNumFailures: u32,
    dwLastResult: u32,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  DS_REPL_KCC_DSA_FAILUREW {.bycopy.} = object
    pszDsaDN: pointer
    uuidDsaObjGuid: GUID
    ftimeFirstFailure: FILETIME
    cNumFailures: uint32
    dwLastResult: uint32
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct DS_REPL_KCC_DSA_FAILUREW
{
    void* pszDsaDN;
    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整数の配列変数で操作します。(x86 レイアウト)
; DS_REPL_KCC_DSA_FAILUREW サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; pszDsaDN : LPWSTR (+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 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DS_REPL_KCC_DSA_FAILUREW サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; pszDsaDN : LPWSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; uuidDsaObjGuid : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; ftimeFirstFailure : FILETIME (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; cNumFailures : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwLastResult : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (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
    #field intptr pszDsaDN
    #field GUID uuidDsaObjGuid
    #field FILETIME ftimeFirstFailure
    #field int cNumFailures
    #field int dwLastResult
#endstruct

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