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

PxeTraceV

関数
可変引数でPXEプロバイダーのトレースメッセージを出力する。
DLLWDSPXE.dll呼出規約winapi

シグネチャ

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

DWORD PxeTraceV(
    HANDLE hProvider,
    DWORD Severity,
    LPCWSTR pszFormat,
    CHAR* Params
);

パラメーター

名前方向
hProviderHANDLEin
SeverityDWORDin
pszFormatLPCWSTRin
ParamsCHAR*in

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD PxeTraceV(
    HANDLE hProvider,
    DWORD Severity,
    LPCWSTR pszFormat,
    CHAR* Params
);
[DllImport("WDSPXE.dll", ExactSpelling = true)]
static extern uint PxeTraceV(
    IntPtr hProvider,   // HANDLE
    uint Severity,   // DWORD
    [MarshalAs(UnmanagedType.LPWStr)] string pszFormat,   // LPCWSTR
    IntPtr Params   // CHAR*
);
<DllImport("WDSPXE.dll", ExactSpelling:=True)>
Public Shared Function PxeTraceV(
    hProvider As IntPtr,   ' HANDLE
    Severity As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPWStr)> pszFormat As String,   ' LPCWSTR
    Params As IntPtr   ' CHAR*
) As UInteger
End Function
' hProvider : HANDLE
' Severity : DWORD
' pszFormat : LPCWSTR
' Params : CHAR*
Declare PtrSafe Function PxeTraceV Lib "wdspxe" ( _
    ByVal hProvider As LongPtr, _
    ByVal Severity As Long, _
    ByVal pszFormat As LongPtr, _
    ByVal Params As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

PxeTraceV = ctypes.windll.wdspxe.PxeTraceV
PxeTraceV.restype = wintypes.DWORD
PxeTraceV.argtypes = [
    wintypes.HANDLE,  # hProvider : HANDLE
    wintypes.DWORD,  # Severity : DWORD
    wintypes.LPCWSTR,  # pszFormat : LPCWSTR
    ctypes.POINTER(ctypes.c_byte),  # Params : CHAR*
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WDSPXE.dll')
PxeTraceV = Fiddle::Function.new(
  lib['PxeTraceV'],
  [
    Fiddle::TYPE_VOIDP,  # hProvider : HANDLE
    -Fiddle::TYPE_INT,  # Severity : DWORD
    Fiddle::TYPE_VOIDP,  # pszFormat : LPCWSTR
    Fiddle::TYPE_VOIDP,  # Params : CHAR*
  ],
  -Fiddle::TYPE_INT)
#[link(name = "wdspxe")]
extern "system" {
    fn PxeTraceV(
        hProvider: *mut core::ffi::c_void,  // HANDLE
        Severity: u32,  // DWORD
        pszFormat: *const u16,  // LPCWSTR
        Params: *mut i8  // CHAR*
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("WDSPXE.dll")]
public static extern uint PxeTraceV(IntPtr hProvider, uint Severity, [MarshalAs(UnmanagedType.LPWStr)] string pszFormat, IntPtr Params);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WDSPXE_PxeTraceV' -Namespace Win32 -PassThru
# $api::PxeTraceV(hProvider, Severity, pszFormat, Params)
#uselib "WDSPXE.dll"
#func global PxeTraceV "PxeTraceV" sptr, sptr, sptr, sptr
; PxeTraceV hProvider, Severity, pszFormat, varptr(Params)   ; 戻り値は stat
; hProvider : HANDLE -> "sptr"
; Severity : DWORD -> "sptr"
; pszFormat : LPCWSTR -> "sptr"
; Params : CHAR* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "WDSPXE.dll"
#cfunc global PxeTraceV "PxeTraceV" sptr, int, wstr, var
; res = PxeTraceV(hProvider, Severity, pszFormat, Params)
; hProvider : HANDLE -> "sptr"
; Severity : DWORD -> "int"
; pszFormat : LPCWSTR -> "wstr"
; Params : CHAR* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; DWORD PxeTraceV(HANDLE hProvider, DWORD Severity, LPCWSTR pszFormat, CHAR* Params)
#uselib "WDSPXE.dll"
#cfunc global PxeTraceV "PxeTraceV" intptr, int, wstr, var
; res = PxeTraceV(hProvider, Severity, pszFormat, Params)
; hProvider : HANDLE -> "intptr"
; Severity : DWORD -> "int"
; pszFormat : LPCWSTR -> "wstr"
; Params : CHAR* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	wdspxe = windows.NewLazySystemDLL("WDSPXE.dll")
	procPxeTraceV = wdspxe.NewProc("PxeTraceV")
)

// hProvider (HANDLE), Severity (DWORD), pszFormat (LPCWSTR), Params (CHAR*)
r1, _, err := procPxeTraceV.Call(
	uintptr(hProvider),
	uintptr(Severity),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszFormat))),
	uintptr(Params),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function PxeTraceV(
  hProvider: THandle;   // HANDLE
  Severity: DWORD;   // DWORD
  pszFormat: PWideChar;   // LPCWSTR
  Params: Pointer   // CHAR*
): DWORD; stdcall;
  external 'WDSPXE.dll' name 'PxeTraceV';
result := DllCall("WDSPXE\PxeTraceV"
    , "Ptr", hProvider   ; HANDLE
    , "UInt", Severity   ; DWORD
    , "WStr", pszFormat   ; LPCWSTR
    , "Ptr", Params   ; CHAR*
    , "UInt")   ; return: DWORD
●PxeTraceV(hProvider, Severity, pszFormat, Params) = DLL("WDSPXE.dll", "dword PxeTraceV(void*, dword, char*, void*)")
# 呼び出し: PxeTraceV(hProvider, Severity, pszFormat, Params)
# hProvider : HANDLE -> "void*"
# Severity : DWORD -> "dword"
# pszFormat : LPCWSTR -> "char*"
# Params : CHAR* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。