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

DsReplicaSyncAllW

関数
ネーミングコンテキスト全体の複製を一括同期する(Unicode版)。
DLLNTDSAPI.dll文字セットUnicode (-W)呼出規約winapi対応OSWindows Vista 以降

シグネチャ

// NTDSAPI.dll  (Unicode / -W)
#include <windows.h>

DWORD DsReplicaSyncAllW(
    HANDLE hDS,
    LPCWSTR pszNameContext,
    DWORD ulFlags,
    INT_PTR pFnCallBack,
    void* pCallbackData,   // optional
    DS_REPSYNCALL_ERRINFOW*** pErrors   // optional
);

パラメーター

名前型方向説明
hDSHANDLEinDSBind 関数または DSBindWithCred 関数から取得したディレクトリサービスハンドルを格納します。
pszNameContextLPCWSTRin同期する名前付けコンテキストの識別名 (DN) を指定する、null で終わる文字列へのポインター。pszNameContext パラメーターは省略可能です。値が NULL の場合は、構成名前付けコンテキストがレプリケートされます。
ulFlagsDWORDin

要求の処理に使用される追加データを渡します。このパラメーターには、次の値を組み合わせて指定できます。

DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE

いずれかのサーバーに接続できない場合、または切断されたトポロジや破損したトポロジが原因でいずれかのサーバーに到達できない場合に、致命的なエラーを生成します。

DS_REPSYNCALL_CROSS_SITE_BOUNDARIES

サイト境界を越えて同期します。既定では、DsReplicaSyncAll はホームシステムと同じサイト内の DC とのみ同期を試みます。エンタープライズフォレスト内のすべての DC との同期を試みるには、このフラグを設定します。ただし、DC を同期できるのは、同期的な (RPC) トランスポートで接続されている場合のみです。

DS_REPSYNCALL_DO_NOT_SYNC

すべての同期を無効にします。トポロジの分析は引き続き行われ、利用できないサーバーや到達できないサーバーの特定も引き続き行われます。

DS_REPSYNCALL_ID_SERVERS_BY_DN

致命的でないエラーが発生した場合に、サーバーの GUID DNS 名ではなく識別名 (DN) を返します。

DS_REPSYNCALL_NO_OPTIONS

このオプションは何も効果がありません。

DS_REPSYNCALL_PUSH_CHANGES_OUTWARD

推移的レプリケーションを使用して、ホームサーバーからすべてのパートナーへ変更をプッシュします。これにより、通常の "プル" 型の実行方式と比べて、レプリケーションの方向とレプリケーションセットの実行順序が逆になります。

DS_REPSYNCALL_SKIP_INITIAL_CHECK

すべてのサーバーが応答していると仮定します。これにより DsReplicaSyncAll 関数の動作は高速になりますが、応答しないサーバーがある場合は、一部の推移的レプリケーションがブロックされる可能性があります。

DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY

推移的レプリケーションを無効にします。同期は隣接するサーバーとの間でのみ実行されます。

pFnCallBackINT_PTRin

アプリケーション定義の SyncUpdateProc 関数へのポインター。この関数は、DsReplicaSyncAll 関数がエラーを検出したとき、2 つのサーバーの同期を開始したとき、2 つのサーバーの同期を完了したとき、またはサイト内のすべてのサーバーの同期を終了したときに呼び出されます。

pCallbackDatavoid*inoptionalpFnCallBack パラメーターが指す SyncUpdateProc コールバック関数の第 1 引数として渡される、アプリケーション定義のデータへのポインター。
pErrorsDS_REPSYNCALL_ERRINFOW***outoptional

同期中に発生したエラーを格納する
DS_REPSYNCALL_ERRINFO 構造体へのポインターの、NULL で終わる配列。ポインターの配列と MsCS\mscs\clusctl_resource_type_get_private_property_fmts.xml のデータの両方を保持するために使用されるメモリは、単一のメモリブロックとして割り当てられます。不要になったら、pErrors で返されたポインター値を引数として LocalFree を 1 回呼び出して解放してください。

- ulFlags.DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE

いずれかのサーバーに接続できない場合、または切断されたトポロジや破損したトポロジが原因でいずれかのサーバーに到達できない場合に、致命的なエラーを生成します。

- ulFlags.DS_REPSYNCALL_CROSS_SITE_BOUNDARIES

サイト境界を越えて同期します。既定では、DsReplicaSyncAll はホームシステムと同じサイト内の DC とのみ同期を試みます。エンタープライズフォレスト内のすべての DC との同期を試みるには、このフラグを設定します。ただし、DC を同期できるのは、同期的な (RPC) トランスポートで接続されている場合のみです。

- ulFlags.DS_REPSYNCALL_DO_NOT_SYNC

すべての同期を無効にします。トポロジの分析は引き続き行われ、利用できないサーバーや到達できないサーバーの特定も引き続き行われます。

- ulFlags.DS_REPSYNCALL_ID_SERVERS_BY_DN

致命的でないエラーが発生した場合に、サーバーの GUID DNS 名ではなく識別名 (DN) を返します。

- ulFlags.DS_REPSYNCALL_NO_OPTIONS

このオプションは何も効果がありません。

- ulFlags.DS_REPSYNCALL_PUSH_CHANGES_OUTWARD

推移的レプリケーションを使用して、ホームサーバーからすべてのパートナーへ変更をプッシュします。これにより、通常の "プル" 型の実行方式と比べて、レプリケーションの方向とレプリケーションセットの実行順序が逆になります。

- ulFlags.DS_REPSYNCALL_SKIP_INITIAL_CHECK

すべてのサーバーが応答していると仮定します。これにより DsReplicaSyncAll 関数の動作は高速になりますが、応答しないサーバーがある場合は、一部の推移的レプリケーションがブロックされる可能性があります。

- ulFlags.DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY

推移的レプリケーションを無効にします。同期は隣接するサーバーとの間でのみ実行されます。

戻り値の型: DWORD

公式ドキュメント

必要に応じて推移的レプリケーションを使用し、サーバーを他のすべてのサーバーと同期します。(Unicode)

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のとおりです。

解説(Remarks)

DsReplicaSyncAll 関数は、同期元となるトポロジを生成する前に、すべてのサーバーへのバインドを試みます。あるサーバーに接続できない場合、この関数はそのサーバーをトポロジから除外し、迂回して処理を行おうとします。ulFlags に DS_REPSYNCALL_SKIP_INITIAL_CHECK フラグを設定すると、この初期バインドは省略されます。

あるサーバーに接続できない場合、ulFlags に DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE が設定されていない限り、DsReplicaSyncAll 関数はそのサーバーを迂回し、可能な限り多くのサーバーからレプリケートしようとします。

DsReplicaSyncAll 関数は、pFnCallBack が指すコールバック関数を使用して、レプリケーションの現在の状態をエンドユーザーに通知できます。DsReplicaSyncAll 関数の実行は、pFnCallBack が指す関数を呼び出す間、一時停止します。コールバック関数の戻り値が TRUE であればレプリケーションは続行され、そうでない場合は DsReplicaSyncAll 関数がレプリケーションを終了します。

メモ

ntdsapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして DsReplicaSyncAll を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、「Conventions for Function Prototypes」を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// NTDSAPI.dll  (Unicode / -W)
#include <windows.h>

DWORD DsReplicaSyncAllW(
    HANDLE hDS,
    LPCWSTR pszNameContext,
    DWORD ulFlags,
    INT_PTR pFnCallBack,
    void* pCallbackData,   // optional
    DS_REPSYNCALL_ERRINFOW*** pErrors   // optional
);
[DllImport("NTDSAPI.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern uint DsReplicaSyncAllW(
    IntPtr hDS,   // HANDLE
    [MarshalAs(UnmanagedType.LPWStr)] string pszNameContext,   // LPCWSTR
    uint ulFlags,   // DWORD
    IntPtr pFnCallBack,   // INT_PTR
    IntPtr pCallbackData,   // void* optional
    IntPtr pErrors   // DS_REPSYNCALL_ERRINFOW*** optional, out
);
<DllImport("NTDSAPI.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function DsReplicaSyncAllW(
    hDS As IntPtr,   ' HANDLE
    <MarshalAs(UnmanagedType.LPWStr)> pszNameContext As String,   ' LPCWSTR
    ulFlags As UInteger,   ' DWORD
    pFnCallBack As IntPtr,   ' INT_PTR
    pCallbackData As IntPtr,   ' void* optional
    pErrors As IntPtr   ' DS_REPSYNCALL_ERRINFOW*** optional, out
) As UInteger
End Function
' hDS : HANDLE
' pszNameContext : LPCWSTR
' ulFlags : DWORD
' pFnCallBack : INT_PTR
' pCallbackData : void* optional
' pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out
Declare PtrSafe Function DsReplicaSyncAllW Lib "ntdsapi" ( _
    ByVal hDS As LongPtr, _
    ByVal pszNameContext As LongPtr, _
    ByVal ulFlags As Long, _
    ByVal pFnCallBack As LongPtr, _
    ByVal pCallbackData As LongPtr, _
    ByVal pErrors As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DsReplicaSyncAllW = ctypes.windll.ntdsapi.DsReplicaSyncAllW
DsReplicaSyncAllW.restype = wintypes.DWORD
DsReplicaSyncAllW.argtypes = [
    wintypes.HANDLE,  # hDS : HANDLE
    wintypes.LPCWSTR,  # pszNameContext : LPCWSTR
    wintypes.DWORD,  # ulFlags : DWORD
    ctypes.c_ssize_t,  # pFnCallBack : INT_PTR
    ctypes.POINTER(None),  # pCallbackData : void* optional
    ctypes.c_void_p,  # pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('NTDSAPI.dll')
DsReplicaSyncAllW = Fiddle::Function.new(
  lib['DsReplicaSyncAllW'],
  [
    Fiddle::TYPE_VOIDP,  # hDS : HANDLE
    Fiddle::TYPE_VOIDP,  # pszNameContext : LPCWSTR
    -Fiddle::TYPE_INT,  # ulFlags : DWORD
    Fiddle::TYPE_INTPTR_T,  # pFnCallBack : INT_PTR
    Fiddle::TYPE_VOIDP,  # pCallbackData : void* optional
    Fiddle::TYPE_VOIDP,  # pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out
  ],
  -Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"
#[link(name = "ntdsapi")]
extern "system" {
    fn DsReplicaSyncAllW(
        hDS: *mut core::ffi::c_void,  // HANDLE
        pszNameContext: *const u16,  // LPCWSTR
        ulFlags: u32,  // DWORD
        pFnCallBack: isize,  // INT_PTR
        pCallbackData: *mut (),  // void* optional
        pErrors: *mut *mut *mut DS_REPSYNCALL_ERRINFOW  // DS_REPSYNCALL_ERRINFOW*** optional, out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("NTDSAPI.dll", CharSet = CharSet.Unicode)]
public static extern uint DsReplicaSyncAllW(IntPtr hDS, [MarshalAs(UnmanagedType.LPWStr)] string pszNameContext, uint ulFlags, IntPtr pFnCallBack, IntPtr pCallbackData, IntPtr pErrors);
"@
$api = Add-Type -MemberDefinition $sig -Name 'NTDSAPI_DsReplicaSyncAllW' -Namespace Win32 -PassThru
# $api::DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
#uselib "NTDSAPI.dll"
#func global DsReplicaSyncAllW "DsReplicaSyncAllW" wptr, wptr, wptr, wptr, wptr, wptr
; DsReplicaSyncAllW hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, varptr(pErrors)   ; 戻り値は stat
; hDS : HANDLE -> "wptr"
; pszNameContext : LPCWSTR -> "wptr"
; ulFlags : DWORD -> "wptr"
; pFnCallBack : INT_PTR -> "wptr"
; pCallbackData : void* optional -> "wptr"
; pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "NTDSAPI.dll"
#cfunc global DsReplicaSyncAllW "DsReplicaSyncAllW" sptr, wstr, int, sptr, sptr, var
; res = DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
; hDS : HANDLE -> "sptr"
; pszNameContext : LPCWSTR -> "wstr"
; ulFlags : DWORD -> "int"
; pFnCallBack : INT_PTR -> "sptr"
; pCallbackData : void* optional -> "sptr"
; pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; DWORD DsReplicaSyncAllW(HANDLE hDS, LPCWSTR pszNameContext, DWORD ulFlags, INT_PTR pFnCallBack, void* pCallbackData, DS_REPSYNCALL_ERRINFOW*** pErrors)
#uselib "NTDSAPI.dll"
#cfunc global DsReplicaSyncAllW "DsReplicaSyncAllW" intptr, wstr, int, intptr, intptr, var
; res = DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
; hDS : HANDLE -> "intptr"
; pszNameContext : LPCWSTR -> "wstr"
; ulFlags : DWORD -> "int"
; pFnCallBack : INT_PTR -> "intptr"
; pCallbackData : void* optional -> "intptr"
; pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	ntdsapi = windows.NewLazySystemDLL("NTDSAPI.dll")
	procDsReplicaSyncAllW = ntdsapi.NewProc("DsReplicaSyncAllW")
)

// hDS (HANDLE), pszNameContext (LPCWSTR), ulFlags (DWORD), pFnCallBack (INT_PTR), pCallbackData (void* optional), pErrors (DS_REPSYNCALL_ERRINFOW*** optional, out)
r1, _, err := procDsReplicaSyncAllW.Call(
	uintptr(hDS),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszNameContext))),
	uintptr(ulFlags),
	uintptr(pFnCallBack),
	uintptr(pCallbackData),
	uintptr(pErrors),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function DsReplicaSyncAllW(
  hDS: THandle;   // HANDLE
  pszNameContext: PWideChar;   // LPCWSTR
  ulFlags: DWORD;   // DWORD
  pFnCallBack: NativeInt;   // INT_PTR
  pCallbackData: Pointer;   // void* optional
  pErrors: Pointer   // DS_REPSYNCALL_ERRINFOW*** optional, out
): DWORD; stdcall;
  external 'NTDSAPI.dll' name 'DsReplicaSyncAllW';
result := DllCall("NTDSAPI\DsReplicaSyncAllW"
    , "Ptr", hDS   ; HANDLE
    , "WStr", pszNameContext   ; LPCWSTR
    , "UInt", ulFlags   ; DWORD
    , "Ptr", pFnCallBack   ; INT_PTR
    , "Ptr", pCallbackData   ; void* optional
    , "Ptr", pErrors   ; DS_REPSYNCALL_ERRINFOW*** optional, out
    , "UInt")   ; return: DWORD
●DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors) = DLL("NTDSAPI.dll", "dword DsReplicaSyncAllW(void*, char*, dword, int, void*, void*)")
# 呼び出し: DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
# hDS : HANDLE -> "void*"
# pszNameContext : LPCWSTR -> "char*"
# ulFlags : DWORD -> "dword"
# pFnCallBack : INT_PTR -> "int"
# pCallbackData : void* optional -> "void*"
# pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。
const std = @import("std");

extern "ntdsapi" fn DsReplicaSyncAllW(
    hDS: ?*anyopaque, // HANDLE
    pszNameContext: [*c]const u16, // LPCWSTR
    ulFlags: u32, // DWORD
    pFnCallBack: isize, // INT_PTR
    pCallbackData: ?*anyopaque, // void* optional
    pErrors: [*c][*c][*c]DS_REPSYNCALL_ERRINFOW // DS_REPSYNCALL_ERRINFOW*** optional, out
) callconv(std.os.windows.WINAPI) u32;
// Unicode(-W): UTF-16LE のヌル終端バッファ([*c]const u16)を渡す。
proc DsReplicaSyncAllW(
    hDS: pointer,  # HANDLE
    pszNameContext: WideCString,  # LPCWSTR
    ulFlags: uint32,  # DWORD
    pFnCallBack: int,  # INT_PTR
    pCallbackData: pointer,  # void* optional
    pErrors: ptr DS_REPSYNCALL_ERRINFOW  # DS_REPSYNCALL_ERRINFOW*** optional, out
): uint32 {.importc: "DsReplicaSyncAllW", stdcall, dynlib: "NTDSAPI.dll".}
# Unicode(-W): WideCString は newWideCString("...") で生成。
pragma(lib, "ntdsapi");
extern(Windows)
uint DsReplicaSyncAllW(
    void* hDS,   // HANDLE
    const(wchar)* pszNameContext,   // LPCWSTR
    uint ulFlags,   // DWORD
    ptrdiff_t pFnCallBack,   // INT_PTR
    void* pCallbackData,   // void* optional
    DS_REPSYNCALL_ERRINFOW*** pErrors   // DS_REPSYNCALL_ERRINFOW*** optional, out
);
ccall((:DsReplicaSyncAllW, "NTDSAPI.dll"), stdcall, UInt32,
      (Ptr{Cvoid}, Cwstring, UInt32, Int, Ptr{Cvoid}, Ptr{DS_REPSYNCALL_ERRINFOW}),
      hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
# hDS : HANDLE -> Ptr{Cvoid}
# pszNameContext : LPCWSTR -> Cwstring
# ulFlags : DWORD -> UInt32
# pFnCallBack : INT_PTR -> Int
# pCallbackData : void* optional -> Ptr{Cvoid}
# pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> Ptr{DS_REPSYNCALL_ERRINFOW}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
# Unicode(-W): Cwstring には transcode(UInt16, "...") 等で UTF-16 を渡す。
local ffi = require("ffi")
ffi.cdef[[
uint32_t DsReplicaSyncAllW(
    void* hDS,
    const uint16_t* pszNameContext,
    uint32_t ulFlags,
    intptr_t pFnCallBack,
    void* pCallbackData,
    void* pErrors);
]]
local ntdsapi = ffi.load("ntdsapi")
-- ntdsapi.DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
-- hDS : HANDLE
-- pszNameContext : LPCWSTR
-- ulFlags : DWORD
-- pFnCallBack : INT_PTR
-- pCallbackData : void* optional
-- pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
-- Unicode(-W): uint16_t* には UTF-16LE のバッファ(ffi.new("uint16_t[?]", ...))を渡す。
const koffi = require('koffi');
const lib = koffi.load('NTDSAPI.dll');
const DsReplicaSyncAllW = lib.func('__stdcall', 'DsReplicaSyncAllW', 'uint32_t', ['void *', 'str16', 'uint32_t', 'intptr_t', 'void *', 'void *']);
// DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
// hDS : HANDLE -> 'void *'
// pszNameContext : LPCWSTR -> 'str16'
// ulFlags : DWORD -> 'uint32_t'
// pFnCallBack : INT_PTR -> 'intptr_t'
// pCallbackData : void* optional -> 'void *'
// pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("NTDSAPI.dll", {
  DsReplicaSyncAllW: { parameters: ["pointer", "buffer", "u32", "isize", "pointer", "pointer"], result: "u32" },
});
// lib.symbols.DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors)
// hDS : HANDLE -> "pointer"
// pszNameContext : LPCWSTR -> "buffer"
// ulFlags : DWORD -> "u32"
// pFnCallBack : INT_PTR -> "isize"
// pCallbackData : void* optional -> "pointer"
// pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> "pointer"
// 文字列は "buffer"。Unicode(-W) は new TextEncoder() ではなく UTF-16LE のバイト列(末尾に \x00\x00)を Uint8Array で渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
uint32_t DsReplicaSyncAllW(
    void* hDS,
    const uint16_t* pszNameContext,
    uint32_t ulFlags,
    intptr_t pFnCallBack,
    void* pCallbackData,
    void* pErrors);
C, "NTDSAPI.dll");
// $ffi->DsReplicaSyncAllW(hDS, pszNameContext, ulFlags, pFnCallBack, pCallbackData, pErrors);
// hDS : HANDLE
// pszNameContext : LPCWSTR
// ulFlags : DWORD
// pFnCallBack : INT_PTR
// pCallbackData : void* optional
// pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Ntdsapi extends StdCallLibrary {
    Ntdsapi INSTANCE = Native.load("ntdsapi", Ntdsapi.class, W32APIOptions.UNICODE_OPTIONS);
    int DsReplicaSyncAllW(
        Pointer hDS,   // HANDLE
        WString pszNameContext,   // LPCWSTR
        int ulFlags,   // DWORD
        long pFnCallBack,   // INT_PTR
        Pointer pCallbackData,   // void* optional
        Pointer pErrors   // DS_REPSYNCALL_ERRINFOW*** optional, out
    );
}
// Unicode(-W): WString(入力)/char[](出力)で UTF-16 をマーシャリング。
@[Link("ntdsapi")]
lib LibNTDSAPI
  fun DsReplicaSyncAllW = DsReplicaSyncAllW(
    hDS : Void*,   # HANDLE
    pszNameContext : UInt16*,   # LPCWSTR
    ulFlags : UInt32,   # DWORD
    pFnCallBack : LibC::SSizeT,   # INT_PTR
    pCallbackData : Void*,   # void* optional
    pErrors : DS_REPSYNCALL_ERRINFOW***   # DS_REPSYNCALL_ERRINFOW*** optional, out
  ) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef DsReplicaSyncAllWNative = Uint32 Function(Pointer<Void>, Pointer<Utf16>, Uint32, IntPtr, Pointer<Void>, Pointer<Void>);
typedef DsReplicaSyncAllWDart = int Function(Pointer<Void>, Pointer<Utf16>, int, int, Pointer<Void>, Pointer<Void>);
final DsReplicaSyncAllW = DynamicLibrary.open('NTDSAPI.dll')
    .lookupFunction<DsReplicaSyncAllWNative, DsReplicaSyncAllWDart>('DsReplicaSyncAllW');
// hDS : HANDLE -> Pointer<Void>
// pszNameContext : LPCWSTR -> Pointer<Utf16>
// ulFlags : DWORD -> Uint32
// pFnCallBack : INT_PTR -> IntPtr
// pCallbackData : void* optional -> Pointer<Void>
// pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function DsReplicaSyncAllW(
  hDS: THandle;   // HANDLE
  pszNameContext: PWideChar;   // LPCWSTR
  ulFlags: DWORD;   // DWORD
  pFnCallBack: NativeInt;   // INT_PTR
  pCallbackData: Pointer;   // void* optional
  pErrors: Pointer   // DS_REPSYNCALL_ERRINFOW*** optional, out
): DWORD; stdcall;
  external 'NTDSAPI.dll' name 'DsReplicaSyncAllW';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "DsReplicaSyncAllW"
  c_DsReplicaSyncAllW :: Ptr () -> CWString -> Word32 -> CIntPtr -> Ptr () -> Ptr () -> IO Word32
-- hDS : HANDLE -> Ptr ()
-- pszNameContext : LPCWSTR -> CWString
-- ulFlags : DWORD -> Word32
-- pFnCallBack : INT_PTR -> CIntPtr
-- pCallbackData : void* optional -> Ptr ()
-- pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let dsreplicasyncallw =
  foreign "DsReplicaSyncAllW"
    ((ptr void) @-> (ptr uint16_t) @-> uint32_t @-> intptr_t @-> (ptr void) @-> (ptr void) @-> returning uint32_t)
(* hDS : HANDLE -> (ptr void) *)
(* pszNameContext : LPCWSTR -> (ptr uint16_t) *)
(* ulFlags : DWORD -> uint32_t *)
(* pFnCallBack : INT_PTR -> intptr_t *)
(* pCallbackData : void* optional -> (ptr void) *)
(* pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library ntdsapi (t "NTDSAPI.dll"))
(cffi:use-foreign-library ntdsapi)

(cffi:defcfun ("DsReplicaSyncAllW" ds-replica-sync-all-w :convention :stdcall) :uint32
  (h-ds :pointer)   ; HANDLE
  (psz-name-context (:string :encoding :utf-16le))   ; LPCWSTR
  (ul-flags :uint32)   ; DWORD
  (p-fn-call-back :int64)   ; INT_PTR
  (p-callback-data :pointer)   ; void* optional
  (p-errors :pointer))   ; DS_REPSYNCALL_ERRINFOW*** optional, out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $DsReplicaSyncAllW = Win32::API::More->new('NTDSAPI',
    'DWORD DsReplicaSyncAllW(HANDLE hDS, LPCWSTR pszNameContext, DWORD ulFlags, LPARAM pFnCallBack, LPVOID pCallbackData, LPVOID pErrors)');
# my $ret = $DsReplicaSyncAllW->Call($hDS, $pszNameContext, $ulFlags, $pFnCallBack, $pCallbackData, $pErrors);
# hDS : HANDLE -> HANDLE
# pszNameContext : LPCWSTR -> LPCWSTR
# ulFlags : DWORD -> DWORD
# pFnCallBack : INT_PTR -> LPARAM
# pCallbackData : void* optional -> LPVOID
# pErrors : DS_REPSYNCALL_ERRINFOW*** optional, out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# Unicode(-W): LPCWSTR/LPWSTR は Win32::API が UTF-16 変換を行う。

関連項目

文字セット違い
公式の関連項目
使用する型