ホーム › System.Diagnostics.Etw › EnumerateTraceGuidsEx

EnumerateTraceGuidsEx

関数

登録済みトレースプロバイダーやセッションの情報を列挙する。

DLLADVAPI32.dll呼出規約winapi対応OSWindows Vista 以降

シグネチャ

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

WIN32_ERROR EnumerateTraceGuidsEx(
    TRACE_QUERY_INFO_CLASS TraceQueryInfoClass,
    void* InBuffer,   // optional
    DWORD InBufferSize,
    void* OutBuffer,   // optional
    DWORD OutBufferSize,
    DWORD* ReturnLength
);

パラメーター

名前	型	方向
TraceQueryInfoClass	TRACE_QUERY_INFO_CLASS	in
InBuffer	void*	inoptional
InBufferSize	DWORD	in
OutBuffer	void*	outoptional
OutBufferSize	DWORD	in
ReturnLength	DWORD*	out

戻り値の型: WIN32_ERROR

各言語での呼び出し定義

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

WIN32_ERROR EnumerateTraceGuidsEx(
    TRACE_QUERY_INFO_CLASS TraceQueryInfoClass,
    void* InBuffer,   // optional
    DWORD InBufferSize,
    void* OutBuffer,   // optional
    DWORD OutBufferSize,
    DWORD* ReturnLength
);

[DllImport("ADVAPI32.dll", ExactSpelling = true)]
static extern uint EnumerateTraceGuidsEx(
    int TraceQueryInfoClass,   // TRACE_QUERY_INFO_CLASS
    IntPtr InBuffer,   // void* optional
    uint InBufferSize,   // DWORD
    IntPtr OutBuffer,   // void* optional, out
    uint OutBufferSize,   // DWORD
    out uint ReturnLength   // DWORD* out
);

<DllImport("ADVAPI32.dll", ExactSpelling:=True)>
Public Shared Function EnumerateTraceGuidsEx(
    TraceQueryInfoClass As Integer,   ' TRACE_QUERY_INFO_CLASS
    InBuffer As IntPtr,   ' void* optional
    InBufferSize As UInteger,   ' DWORD
    OutBuffer As IntPtr,   ' void* optional, out
    OutBufferSize As UInteger,   ' DWORD
    <Out> ByRef ReturnLength As UInteger   ' DWORD* out
) As UInteger
End Function

' TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS
' InBuffer : void* optional
' InBufferSize : DWORD
' OutBuffer : void* optional, out
' OutBufferSize : DWORD
' ReturnLength : DWORD* out
Declare PtrSafe Function EnumerateTraceGuidsEx Lib "advapi32" ( _
    ByVal TraceQueryInfoClass As Long, _
    ByVal InBuffer As LongPtr, _
    ByVal InBufferSize As Long, _
    ByVal OutBuffer As LongPtr, _
    ByVal OutBufferSize As Long, _
    ByRef ReturnLength As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

EnumerateTraceGuidsEx = ctypes.windll.advapi32.EnumerateTraceGuidsEx
EnumerateTraceGuidsEx.restype = wintypes.DWORD
EnumerateTraceGuidsEx.argtypes = [
    ctypes.c_int,  # TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS
    ctypes.POINTER(None),  # InBuffer : void* optional
    wintypes.DWORD,  # InBufferSize : DWORD
    ctypes.POINTER(None),  # OutBuffer : void* optional, out
    wintypes.DWORD,  # OutBufferSize : DWORD
    ctypes.POINTER(wintypes.DWORD),  # ReturnLength : DWORD* out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
EnumerateTraceGuidsEx = Fiddle::Function.new(
  lib['EnumerateTraceGuidsEx'],
  [
    Fiddle::TYPE_INT,  # TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS
    Fiddle::TYPE_VOIDP,  # InBuffer : void* optional
    -Fiddle::TYPE_INT,  # InBufferSize : DWORD
    Fiddle::TYPE_VOIDP,  # OutBuffer : void* optional, out
    -Fiddle::TYPE_INT,  # OutBufferSize : DWORD
    Fiddle::TYPE_VOIDP,  # ReturnLength : DWORD* out
  ],
  -Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn EnumerateTraceGuidsEx(
        TraceQueryInfoClass: i32,  // TRACE_QUERY_INFO_CLASS
        InBuffer: *mut (),  // void* optional
        InBufferSize: u32,  // DWORD
        OutBuffer: *mut (),  // void* optional, out
        OutBufferSize: u32,  // DWORD
        ReturnLength: *mut u32  // DWORD* out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ADVAPI32.dll")]
public static extern uint EnumerateTraceGuidsEx(int TraceQueryInfoClass, IntPtr InBuffer, uint InBufferSize, IntPtr OutBuffer, uint OutBufferSize, out uint ReturnLength);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_EnumerateTraceGuidsEx' -Namespace Win32 -PassThru
# $api::EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, ReturnLength)

#uselib "ADVAPI32.dll"
#func global EnumerateTraceGuidsEx "EnumerateTraceGuidsEx" sptr, sptr, sptr, sptr, sptr, sptr
; EnumerateTraceGuidsEx TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, varptr(ReturnLength)   ; 戻り値は stat
; TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS -> "sptr"
; InBuffer : void* optional -> "sptr"
; InBufferSize : DWORD -> "sptr"
; OutBuffer : void* optional, out -> "sptr"
; OutBufferSize : DWORD -> "sptr"
; ReturnLength : DWORD* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ADVAPI32.dll"
#cfunc global EnumerateTraceGuidsEx "EnumerateTraceGuidsEx" int, sptr, int, sptr, int, var
; res = EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, ReturnLength)
; TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS -> "int"
; InBuffer : void* optional -> "sptr"
; InBufferSize : DWORD -> "int"
; OutBuffer : void* optional, out -> "sptr"
; OutBufferSize : DWORD -> "int"
; ReturnLength : DWORD* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll"
#cfunc global EnumerateTraceGuidsEx "EnumerateTraceGuidsEx" int, sptr, int, sptr, int, sptr
; res = EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, varptr(ReturnLength))
; TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS -> "int"
; InBuffer : void* optional -> "sptr"
; InBufferSize : DWORD -> "int"
; OutBuffer : void* optional, out -> "sptr"
; OutBufferSize : DWORD -> "int"
; ReturnLength : DWORD* out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; WIN32_ERROR EnumerateTraceGuidsEx(TRACE_QUERY_INFO_CLASS TraceQueryInfoClass, void* InBuffer, DWORD InBufferSize, void* OutBuffer, DWORD OutBufferSize, DWORD* ReturnLength)
#uselib "ADVAPI32.dll"
#cfunc global EnumerateTraceGuidsEx "EnumerateTraceGuidsEx" int, intptr, int, intptr, int, var
; res = EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, ReturnLength)
; TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS -> "int"
; InBuffer : void* optional -> "intptr"
; InBufferSize : DWORD -> "int"
; OutBuffer : void* optional, out -> "intptr"
; OutBufferSize : DWORD -> "int"
; ReturnLength : DWORD* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; WIN32_ERROR EnumerateTraceGuidsEx(TRACE_QUERY_INFO_CLASS TraceQueryInfoClass, void* InBuffer, DWORD InBufferSize, void* OutBuffer, DWORD OutBufferSize, DWORD* ReturnLength)
#uselib "ADVAPI32.dll"
#cfunc global EnumerateTraceGuidsEx "EnumerateTraceGuidsEx" int, intptr, int, intptr, int, intptr
; res = EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, varptr(ReturnLength))
; TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS -> "int"
; InBuffer : void* optional -> "intptr"
; InBufferSize : DWORD -> "int"
; OutBuffer : void* optional, out -> "intptr"
; OutBufferSize : DWORD -> "int"
; ReturnLength : DWORD* out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	advapi32 = windows.NewLazySystemDLL("ADVAPI32.dll")
	procEnumerateTraceGuidsEx = advapi32.NewProc("EnumerateTraceGuidsEx")
)

// TraceQueryInfoClass (TRACE_QUERY_INFO_CLASS), InBuffer (void* optional), InBufferSize (DWORD), OutBuffer (void* optional, out), OutBufferSize (DWORD), ReturnLength (DWORD* out)
r1, _, err := procEnumerateTraceGuidsEx.Call(
	uintptr(TraceQueryInfoClass),
	uintptr(InBuffer),
	uintptr(InBufferSize),
	uintptr(OutBuffer),
	uintptr(OutBufferSize),
	uintptr(ReturnLength),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // WIN32_ERROR

function EnumerateTraceGuidsEx(
  TraceQueryInfoClass: Integer;   // TRACE_QUERY_INFO_CLASS
  InBuffer: Pointer;   // void* optional
  InBufferSize: DWORD;   // DWORD
  OutBuffer: Pointer;   // void* optional, out
  OutBufferSize: DWORD;   // DWORD
  ReturnLength: Pointer   // DWORD* out
): DWORD; stdcall;
  external 'ADVAPI32.dll' name 'EnumerateTraceGuidsEx';

result := DllCall("ADVAPI32\EnumerateTraceGuidsEx"
    , "Int", TraceQueryInfoClass   ; TRACE_QUERY_INFO_CLASS
    , "Ptr", InBuffer   ; void* optional
    , "UInt", InBufferSize   ; DWORD
    , "Ptr", OutBuffer   ; void* optional, out
    , "UInt", OutBufferSize   ; DWORD
    , "Ptr", ReturnLength   ; DWORD* out
    , "UInt")   ; return: WIN32_ERROR

●EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, ReturnLength) = DLL("ADVAPI32.dll", "dword EnumerateTraceGuidsEx(int, void*, dword, void*, dword, void*)")
# 呼び出し: EnumerateTraceGuidsEx(TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, ReturnLength)
# TraceQueryInfoClass : TRACE_QUERY_INFO_CLASS -> "int"
# InBuffer : void* optional -> "void*"
# InBufferSize : DWORD -> "dword"
# OutBuffer : void* optional, out -> "void*"
# OutBufferSize : DWORD -> "dword"
# ReturnLength : DWORD* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。