ホーム › System.EventLog › EvtGetChannelConfigProperty
EvtGetChannelConfigProperty
関数チャネル構成のプロパティ値を取得する。
シグネチャ
// wevtapi.dll
#include <windows.h>
BOOL EvtGetChannelConfigProperty(
EVT_HANDLE ChannelConfig,
EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
DWORD Flags,
DWORD PropertyValueBufferSize,
EVT_VARIANT* PropertyValueBuffer, // optional
DWORD* PropertyValueBufferUsed
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| ChannelConfig | EVT_HANDLE | in |
| PropertyId | EVT_CHANNEL_CONFIG_PROPERTY_ID | in |
| Flags | DWORD | in |
| PropertyValueBufferSize | DWORD | in |
| PropertyValueBuffer | EVT_VARIANT* | outoptional |
| PropertyValueBufferUsed | DWORD* | out |
戻り値の型: BOOL
各言語での呼び出し定義
// wevtapi.dll
#include <windows.h>
BOOL EvtGetChannelConfigProperty(
EVT_HANDLE ChannelConfig,
EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
DWORD Flags,
DWORD PropertyValueBufferSize,
EVT_VARIANT* PropertyValueBuffer, // optional
DWORD* PropertyValueBufferUsed
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("wevtapi.dll", SetLastError = true, ExactSpelling = true)]
static extern bool EvtGetChannelConfigProperty(
IntPtr ChannelConfig, // EVT_HANDLE
int PropertyId, // EVT_CHANNEL_CONFIG_PROPERTY_ID
uint Flags, // DWORD
uint PropertyValueBufferSize, // DWORD
IntPtr PropertyValueBuffer, // EVT_VARIANT* optional, out
out uint PropertyValueBufferUsed // DWORD* out
);<DllImport("wevtapi.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function EvtGetChannelConfigProperty(
ChannelConfig As IntPtr, ' EVT_HANDLE
PropertyId As Integer, ' EVT_CHANNEL_CONFIG_PROPERTY_ID
Flags As UInteger, ' DWORD
PropertyValueBufferSize As UInteger, ' DWORD
PropertyValueBuffer As IntPtr, ' EVT_VARIANT* optional, out
<Out> ByRef PropertyValueBufferUsed As UInteger ' DWORD* out
) As Boolean
End Function' ChannelConfig : EVT_HANDLE
' PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID
' Flags : DWORD
' PropertyValueBufferSize : DWORD
' PropertyValueBuffer : EVT_VARIANT* optional, out
' PropertyValueBufferUsed : DWORD* out
Declare PtrSafe Function EvtGetChannelConfigProperty Lib "wevtapi" ( _
ByVal ChannelConfig As LongPtr, _
ByVal PropertyId As Long, _
ByVal Flags As Long, _
ByVal PropertyValueBufferSize As Long, _
ByVal PropertyValueBuffer As LongPtr, _
ByRef PropertyValueBufferUsed As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
EvtGetChannelConfigProperty = ctypes.windll.wevtapi.EvtGetChannelConfigProperty
EvtGetChannelConfigProperty.restype = wintypes.BOOL
EvtGetChannelConfigProperty.argtypes = [
ctypes.c_ssize_t, # ChannelConfig : EVT_HANDLE
ctypes.c_int, # PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID
wintypes.DWORD, # Flags : DWORD
wintypes.DWORD, # PropertyValueBufferSize : DWORD
ctypes.c_void_p, # PropertyValueBuffer : EVT_VARIANT* optional, out
ctypes.POINTER(wintypes.DWORD), # PropertyValueBufferUsed : DWORD* out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('wevtapi.dll')
EvtGetChannelConfigProperty = Fiddle::Function.new(
lib['EvtGetChannelConfigProperty'],
[
Fiddle::TYPE_INTPTR_T, # ChannelConfig : EVT_HANDLE
Fiddle::TYPE_INT, # PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID
-Fiddle::TYPE_INT, # Flags : DWORD
-Fiddle::TYPE_INT, # PropertyValueBufferSize : DWORD
Fiddle::TYPE_VOIDP, # PropertyValueBuffer : EVT_VARIANT* optional, out
Fiddle::TYPE_VOIDP, # PropertyValueBufferUsed : DWORD* out
],
Fiddle::TYPE_INT)#[link(name = "wevtapi")]
extern "system" {
fn EvtGetChannelConfigProperty(
ChannelConfig: isize, // EVT_HANDLE
PropertyId: i32, // EVT_CHANNEL_CONFIG_PROPERTY_ID
Flags: u32, // DWORD
PropertyValueBufferSize: u32, // DWORD
PropertyValueBuffer: *mut EVT_VARIANT, // EVT_VARIANT* optional, out
PropertyValueBufferUsed: *mut u32 // DWORD* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("wevtapi.dll", SetLastError = true)]
public static extern bool EvtGetChannelConfigProperty(IntPtr ChannelConfig, int PropertyId, uint Flags, uint PropertyValueBufferSize, IntPtr PropertyValueBuffer, out uint PropertyValueBufferUsed);
"@
$api = Add-Type -MemberDefinition $sig -Name 'wevtapi_EvtGetChannelConfigProperty' -Namespace Win32 -PassThru
# $api::EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, PropertyValueBuffer, PropertyValueBufferUsed)#uselib "wevtapi.dll"
#func global EvtGetChannelConfigProperty "EvtGetChannelConfigProperty" sptr, sptr, sptr, sptr, sptr, sptr
; EvtGetChannelConfigProperty ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, varptr(PropertyValueBuffer), varptr(PropertyValueBufferUsed) ; 戻り値は stat
; ChannelConfig : EVT_HANDLE -> "sptr"
; PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID -> "sptr"
; Flags : DWORD -> "sptr"
; PropertyValueBufferSize : DWORD -> "sptr"
; PropertyValueBuffer : EVT_VARIANT* optional, out -> "sptr"
; PropertyValueBufferUsed : DWORD* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "wevtapi.dll" #cfunc global EvtGetChannelConfigProperty "EvtGetChannelConfigProperty" sptr, int, int, int, var, var ; res = EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, PropertyValueBuffer, PropertyValueBufferUsed) ; ChannelConfig : EVT_HANDLE -> "sptr" ; PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID -> "int" ; Flags : DWORD -> "int" ; PropertyValueBufferSize : DWORD -> "int" ; PropertyValueBuffer : EVT_VARIANT* optional, out -> "var" ; PropertyValueBufferUsed : DWORD* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "wevtapi.dll" #cfunc global EvtGetChannelConfigProperty "EvtGetChannelConfigProperty" sptr, int, int, int, sptr, sptr ; res = EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, varptr(PropertyValueBuffer), varptr(PropertyValueBufferUsed)) ; ChannelConfig : EVT_HANDLE -> "sptr" ; PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID -> "int" ; Flags : DWORD -> "int" ; PropertyValueBufferSize : DWORD -> "int" ; PropertyValueBuffer : EVT_VARIANT* optional, out -> "sptr" ; PropertyValueBufferUsed : DWORD* out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; BOOL EvtGetChannelConfigProperty(EVT_HANDLE ChannelConfig, EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId, DWORD Flags, DWORD PropertyValueBufferSize, EVT_VARIANT* PropertyValueBuffer, DWORD* PropertyValueBufferUsed) #uselib "wevtapi.dll" #cfunc global EvtGetChannelConfigProperty "EvtGetChannelConfigProperty" intptr, int, int, int, var, var ; res = EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, PropertyValueBuffer, PropertyValueBufferUsed) ; ChannelConfig : EVT_HANDLE -> "intptr" ; PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID -> "int" ; Flags : DWORD -> "int" ; PropertyValueBufferSize : DWORD -> "int" ; PropertyValueBuffer : EVT_VARIANT* optional, out -> "var" ; PropertyValueBufferUsed : DWORD* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL EvtGetChannelConfigProperty(EVT_HANDLE ChannelConfig, EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId, DWORD Flags, DWORD PropertyValueBufferSize, EVT_VARIANT* PropertyValueBuffer, DWORD* PropertyValueBufferUsed) #uselib "wevtapi.dll" #cfunc global EvtGetChannelConfigProperty "EvtGetChannelConfigProperty" intptr, int, int, int, intptr, intptr ; res = EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, varptr(PropertyValueBuffer), varptr(PropertyValueBufferUsed)) ; ChannelConfig : EVT_HANDLE -> "intptr" ; PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID -> "int" ; Flags : DWORD -> "int" ; PropertyValueBufferSize : DWORD -> "int" ; PropertyValueBuffer : EVT_VARIANT* optional, out -> "intptr" ; PropertyValueBufferUsed : DWORD* out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
wevtapi = windows.NewLazySystemDLL("wevtapi.dll")
procEvtGetChannelConfigProperty = wevtapi.NewProc("EvtGetChannelConfigProperty")
)
// ChannelConfig (EVT_HANDLE), PropertyId (EVT_CHANNEL_CONFIG_PROPERTY_ID), Flags (DWORD), PropertyValueBufferSize (DWORD), PropertyValueBuffer (EVT_VARIANT* optional, out), PropertyValueBufferUsed (DWORD* out)
r1, _, err := procEvtGetChannelConfigProperty.Call(
uintptr(ChannelConfig),
uintptr(PropertyId),
uintptr(Flags),
uintptr(PropertyValueBufferSize),
uintptr(PropertyValueBuffer),
uintptr(PropertyValueBufferUsed),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction EvtGetChannelConfigProperty(
ChannelConfig: NativeInt; // EVT_HANDLE
PropertyId: Integer; // EVT_CHANNEL_CONFIG_PROPERTY_ID
Flags: DWORD; // DWORD
PropertyValueBufferSize: DWORD; // DWORD
PropertyValueBuffer: Pointer; // EVT_VARIANT* optional, out
PropertyValueBufferUsed: Pointer // DWORD* out
): BOOL; stdcall;
external 'wevtapi.dll' name 'EvtGetChannelConfigProperty';result := DllCall("wevtapi\EvtGetChannelConfigProperty"
, "Ptr", ChannelConfig ; EVT_HANDLE
, "Int", PropertyId ; EVT_CHANNEL_CONFIG_PROPERTY_ID
, "UInt", Flags ; DWORD
, "UInt", PropertyValueBufferSize ; DWORD
, "Ptr", PropertyValueBuffer ; EVT_VARIANT* optional, out
, "Ptr", PropertyValueBufferUsed ; DWORD* out
, "Int") ; return: BOOL●EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, PropertyValueBuffer, PropertyValueBufferUsed) = DLL("wevtapi.dll", "bool EvtGetChannelConfigProperty(int, int, dword, dword, void*, void*)")
# 呼び出し: EvtGetChannelConfigProperty(ChannelConfig, PropertyId, Flags, PropertyValueBufferSize, PropertyValueBuffer, PropertyValueBufferUsed)
# ChannelConfig : EVT_HANDLE -> "int"
# PropertyId : EVT_CHANNEL_CONFIG_PROPERTY_ID -> "int"
# Flags : DWORD -> "dword"
# PropertyValueBufferSize : DWORD -> "dword"
# PropertyValueBuffer : EVT_VARIANT* optional, out -> "void*"
# PropertyValueBufferUsed : DWORD* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。