Win32 API 日本語リファレンス
ホームSystem.DataExchange › DdeClientTransaction

DdeClientTransaction

関数
DDEクライアントがサーバーへデータ要求や送信を行う。
DLLUSER32.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// USER32.dll
#include <windows.h>

HDDEDATA DdeClientTransaction(
    BYTE* pData,   // optional
    DWORD cbData,
    HCONV hConv,
    HSZ hszItem,   // optional
    DWORD wFmt,
    DDE_CLIENT_TRANSACTION_TYPE wType,
    DWORD dwTimeout,
    DWORD* pdwResult   // optional
);

パラメーター

名前方向
pDataBYTE*inoptional
cbDataDWORDin
hConvHCONVin
hszItemHSZinoptional
wFmtDWORDin
wTypeDDE_CLIENT_TRANSACTION_TYPEin
dwTimeoutDWORDin
pdwResultDWORD*outoptional

戻り値の型: HDDEDATA

各言語での呼び出し定義

// USER32.dll
#include <windows.h>

HDDEDATA DdeClientTransaction(
    BYTE* pData,   // optional
    DWORD cbData,
    HCONV hConv,
    HSZ hszItem,   // optional
    DWORD wFmt,
    DDE_CLIENT_TRANSACTION_TYPE wType,
    DWORD dwTimeout,
    DWORD* pdwResult   // optional
);
[DllImport("USER32.dll", ExactSpelling = true)]
static extern IntPtr DdeClientTransaction(
    IntPtr pData,   // BYTE* optional
    uint cbData,   // DWORD
    IntPtr hConv,   // HCONV
    IntPtr hszItem,   // HSZ optional
    uint wFmt,   // DWORD
    uint wType,   // DDE_CLIENT_TRANSACTION_TYPE
    uint dwTimeout,   // DWORD
    IntPtr pdwResult   // DWORD* optional, out
);
<DllImport("USER32.dll", ExactSpelling:=True)>
Public Shared Function DdeClientTransaction(
    pData As IntPtr,   ' BYTE* optional
    cbData As UInteger,   ' DWORD
    hConv As IntPtr,   ' HCONV
    hszItem As IntPtr,   ' HSZ optional
    wFmt As UInteger,   ' DWORD
    wType As UInteger,   ' DDE_CLIENT_TRANSACTION_TYPE
    dwTimeout As UInteger,   ' DWORD
    pdwResult As IntPtr   ' DWORD* optional, out
) As IntPtr
End Function
' pData : BYTE* optional
' cbData : DWORD
' hConv : HCONV
' hszItem : HSZ optional
' wFmt : DWORD
' wType : DDE_CLIENT_TRANSACTION_TYPE
' dwTimeout : DWORD
' pdwResult : DWORD* optional, out
Declare PtrSafe Function DdeClientTransaction Lib "user32" ( _
    ByVal pData As LongPtr, _
    ByVal cbData As Long, _
    ByVal hConv As LongPtr, _
    ByVal hszItem As LongPtr, _
    ByVal wFmt As Long, _
    ByVal wType As Long, _
    ByVal dwTimeout As Long, _
    ByVal pdwResult As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DdeClientTransaction = ctypes.windll.user32.DdeClientTransaction
DdeClientTransaction.restype = ctypes.c_void_p
DdeClientTransaction.argtypes = [
    ctypes.POINTER(ctypes.c_ubyte),  # pData : BYTE* optional
    wintypes.DWORD,  # cbData : DWORD
    wintypes.HANDLE,  # hConv : HCONV
    wintypes.HANDLE,  # hszItem : HSZ optional
    wintypes.DWORD,  # wFmt : DWORD
    wintypes.DWORD,  # wType : DDE_CLIENT_TRANSACTION_TYPE
    wintypes.DWORD,  # dwTimeout : DWORD
    ctypes.POINTER(wintypes.DWORD),  # pdwResult : DWORD* optional, out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('USER32.dll')
DdeClientTransaction = Fiddle::Function.new(
  lib['DdeClientTransaction'],
  [
    Fiddle::TYPE_VOIDP,  # pData : BYTE* optional
    -Fiddle::TYPE_INT,  # cbData : DWORD
    Fiddle::TYPE_VOIDP,  # hConv : HCONV
    Fiddle::TYPE_VOIDP,  # hszItem : HSZ optional
    -Fiddle::TYPE_INT,  # wFmt : DWORD
    -Fiddle::TYPE_INT,  # wType : DDE_CLIENT_TRANSACTION_TYPE
    -Fiddle::TYPE_INT,  # dwTimeout : DWORD
    Fiddle::TYPE_VOIDP,  # pdwResult : DWORD* optional, out
  ],
  Fiddle::TYPE_VOIDP)
#[link(name = "user32")]
extern "system" {
    fn DdeClientTransaction(
        pData: *mut u8,  // BYTE* optional
        cbData: u32,  // DWORD
        hConv: *mut core::ffi::c_void,  // HCONV
        hszItem: *mut core::ffi::c_void,  // HSZ optional
        wFmt: u32,  // DWORD
        wType: u32,  // DDE_CLIENT_TRANSACTION_TYPE
        dwTimeout: u32,  // DWORD
        pdwResult: *mut u32  // DWORD* optional, out
    ) -> *mut core::ffi::c_void;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("USER32.dll")]
public static extern IntPtr DdeClientTransaction(IntPtr pData, uint cbData, IntPtr hConv, IntPtr hszItem, uint wFmt, uint wType, uint dwTimeout, IntPtr pdwResult);
"@
$api = Add-Type -MemberDefinition $sig -Name 'USER32_DdeClientTransaction' -Namespace Win32 -PassThru
# $api::DdeClientTransaction(pData, cbData, hConv, hszItem, wFmt, wType, dwTimeout, pdwResult)
#uselib "USER32.dll"
#func global DdeClientTransaction "DdeClientTransaction" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; DdeClientTransaction varptr(pData), cbData, hConv, hszItem, wFmt, wType, dwTimeout, varptr(pdwResult)   ; 戻り値は stat
; pData : BYTE* optional -> "sptr"
; cbData : DWORD -> "sptr"
; hConv : HCONV -> "sptr"
; hszItem : HSZ optional -> "sptr"
; wFmt : DWORD -> "sptr"
; wType : DDE_CLIENT_TRANSACTION_TYPE -> "sptr"
; dwTimeout : DWORD -> "sptr"
; pdwResult : DWORD* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "USER32.dll"
#cfunc global DdeClientTransaction "DdeClientTransaction" var, int, sptr, sptr, int, int, int, var
; res = DdeClientTransaction(pData, cbData, hConv, hszItem, wFmt, wType, dwTimeout, pdwResult)
; pData : BYTE* optional -> "var"
; cbData : DWORD -> "int"
; hConv : HCONV -> "sptr"
; hszItem : HSZ optional -> "sptr"
; wFmt : DWORD -> "int"
; wType : DDE_CLIENT_TRANSACTION_TYPE -> "int"
; dwTimeout : DWORD -> "int"
; pdwResult : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; HDDEDATA DdeClientTransaction(BYTE* pData, DWORD cbData, HCONV hConv, HSZ hszItem, DWORD wFmt, DDE_CLIENT_TRANSACTION_TYPE wType, DWORD dwTimeout, DWORD* pdwResult)
#uselib "USER32.dll"
#cfunc global DdeClientTransaction "DdeClientTransaction" var, int, intptr, intptr, int, int, int, var
; res = DdeClientTransaction(pData, cbData, hConv, hszItem, wFmt, wType, dwTimeout, pdwResult)
; pData : BYTE* optional -> "var"
; cbData : DWORD -> "int"
; hConv : HCONV -> "intptr"
; hszItem : HSZ optional -> "intptr"
; wFmt : DWORD -> "int"
; wType : DDE_CLIENT_TRANSACTION_TYPE -> "int"
; dwTimeout : DWORD -> "int"
; pdwResult : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	user32 = windows.NewLazySystemDLL("USER32.dll")
	procDdeClientTransaction = user32.NewProc("DdeClientTransaction")
)

// pData (BYTE* optional), cbData (DWORD), hConv (HCONV), hszItem (HSZ optional), wFmt (DWORD), wType (DDE_CLIENT_TRANSACTION_TYPE), dwTimeout (DWORD), pdwResult (DWORD* optional, out)
r1, _, err := procDdeClientTransaction.Call(
	uintptr(pData),
	uintptr(cbData),
	uintptr(hConv),
	uintptr(hszItem),
	uintptr(wFmt),
	uintptr(wType),
	uintptr(dwTimeout),
	uintptr(pdwResult),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HDDEDATA
function DdeClientTransaction(
  pData: Pointer;   // BYTE* optional
  cbData: DWORD;   // DWORD
  hConv: THandle;   // HCONV
  hszItem: THandle;   // HSZ optional
  wFmt: DWORD;   // DWORD
  wType: DWORD;   // DDE_CLIENT_TRANSACTION_TYPE
  dwTimeout: DWORD;   // DWORD
  pdwResult: Pointer   // DWORD* optional, out
): THandle; stdcall;
  external 'USER32.dll' name 'DdeClientTransaction';
result := DllCall("USER32\DdeClientTransaction"
    , "Ptr", pData   ; BYTE* optional
    , "UInt", cbData   ; DWORD
    , "Ptr", hConv   ; HCONV
    , "Ptr", hszItem   ; HSZ optional
    , "UInt", wFmt   ; DWORD
    , "UInt", wType   ; DDE_CLIENT_TRANSACTION_TYPE
    , "UInt", dwTimeout   ; DWORD
    , "Ptr", pdwResult   ; DWORD* optional, out
    , "Ptr")   ; return: HDDEDATA
●DdeClientTransaction(pData, cbData, hConv, hszItem, wFmt, wType, dwTimeout, pdwResult) = DLL("USER32.dll", "void* DdeClientTransaction(void*, dword, void*, void*, dword, dword, dword, void*)")
# 呼び出し: DdeClientTransaction(pData, cbData, hConv, hszItem, wFmt, wType, dwTimeout, pdwResult)
# pData : BYTE* optional -> "void*"
# cbData : DWORD -> "dword"
# hConv : HCONV -> "void*"
# hszItem : HSZ optional -> "void*"
# wFmt : DWORD -> "dword"
# wType : DDE_CLIENT_TRANSACTION_TYPE -> "dword"
# dwTimeout : DWORD -> "dword"
# pdwResult : DWORD* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。