Win32 API 日本語リファレンス
ホームSecurity.DiagnosticDataQuery › DdqGetDiagnosticRecordPage

DdqGetDiagnosticRecordPage

関数
検索条件に基づき診断レコードのページを取得する。
DLLDiagnosticDataQuery.dll呼出規約winapi対応OSWindows 10 以降

シグネチャ

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

HRESULT DdqGetDiagnosticRecordPage(
    HDIAGNOSTIC_DATA_QUERY_SESSION hSession,
    DIAGNOSTIC_DATA_SEARCH_CRITERIA* searchCriteria,
    DWORD offset,
    DWORD pageRecordCount,
    LONGLONG baseRowId,
    HDIAGNOSTIC_RECORD* hRecord
);

パラメーター

名前方向
hSessionHDIAGNOSTIC_DATA_QUERY_SESSIONin
searchCriteriaDIAGNOSTIC_DATA_SEARCH_CRITERIA*in
offsetDWORDin
pageRecordCountDWORDin
baseRowIdLONGLONGin
hRecordHDIAGNOSTIC_RECORD*out

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT DdqGetDiagnosticRecordPage(
    HDIAGNOSTIC_DATA_QUERY_SESSION hSession,
    DIAGNOSTIC_DATA_SEARCH_CRITERIA* searchCriteria,
    DWORD offset,
    DWORD pageRecordCount,
    LONGLONG baseRowId,
    HDIAGNOSTIC_RECORD* hRecord
);
[DllImport("DiagnosticDataQuery.dll", ExactSpelling = true)]
static extern int DdqGetDiagnosticRecordPage(
    IntPtr hSession,   // HDIAGNOSTIC_DATA_QUERY_SESSION
    IntPtr searchCriteria,   // DIAGNOSTIC_DATA_SEARCH_CRITERIA*
    uint offset,   // DWORD
    uint pageRecordCount,   // DWORD
    long baseRowId,   // LONGLONG
    IntPtr hRecord   // HDIAGNOSTIC_RECORD* out
);
<DllImport("DiagnosticDataQuery.dll", ExactSpelling:=True)>
Public Shared Function DdqGetDiagnosticRecordPage(
    hSession As IntPtr,   ' HDIAGNOSTIC_DATA_QUERY_SESSION
    searchCriteria As IntPtr,   ' DIAGNOSTIC_DATA_SEARCH_CRITERIA*
    offset As UInteger,   ' DWORD
    pageRecordCount As UInteger,   ' DWORD
    baseRowId As Long,   ' LONGLONG
    hRecord As IntPtr   ' HDIAGNOSTIC_RECORD* out
) As Integer
End Function
' hSession : HDIAGNOSTIC_DATA_QUERY_SESSION
' searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA*
' offset : DWORD
' pageRecordCount : DWORD
' baseRowId : LONGLONG
' hRecord : HDIAGNOSTIC_RECORD* out
Declare PtrSafe Function DdqGetDiagnosticRecordPage Lib "diagnosticdataquery" ( _
    ByVal hSession As LongPtr, _
    ByVal searchCriteria As LongPtr, _
    ByVal offset As Long, _
    ByVal pageRecordCount As Long, _
    ByVal baseRowId As LongLong, _
    ByVal hRecord As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DdqGetDiagnosticRecordPage = ctypes.windll.diagnosticdataquery.DdqGetDiagnosticRecordPage
DdqGetDiagnosticRecordPage.restype = ctypes.c_int
DdqGetDiagnosticRecordPage.argtypes = [
    wintypes.HANDLE,  # hSession : HDIAGNOSTIC_DATA_QUERY_SESSION
    ctypes.c_void_p,  # searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA*
    wintypes.DWORD,  # offset : DWORD
    wintypes.DWORD,  # pageRecordCount : DWORD
    ctypes.c_longlong,  # baseRowId : LONGLONG
    ctypes.c_void_p,  # hRecord : HDIAGNOSTIC_RECORD* out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('DiagnosticDataQuery.dll')
DdqGetDiagnosticRecordPage = Fiddle::Function.new(
  lib['DdqGetDiagnosticRecordPage'],
  [
    Fiddle::TYPE_VOIDP,  # hSession : HDIAGNOSTIC_DATA_QUERY_SESSION
    Fiddle::TYPE_VOIDP,  # searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA*
    -Fiddle::TYPE_INT,  # offset : DWORD
    -Fiddle::TYPE_INT,  # pageRecordCount : DWORD
    Fiddle::TYPE_LONG_LONG,  # baseRowId : LONGLONG
    Fiddle::TYPE_VOIDP,  # hRecord : HDIAGNOSTIC_RECORD* out
  ],
  Fiddle::TYPE_INT)
#[link(name = "diagnosticdataquery")]
extern "system" {
    fn DdqGetDiagnosticRecordPage(
        hSession: *mut core::ffi::c_void,  // HDIAGNOSTIC_DATA_QUERY_SESSION
        searchCriteria: *mut DIAGNOSTIC_DATA_SEARCH_CRITERIA,  // DIAGNOSTIC_DATA_SEARCH_CRITERIA*
        offset: u32,  // DWORD
        pageRecordCount: u32,  // DWORD
        baseRowId: i64,  // LONGLONG
        hRecord: *mut *mut core::ffi::c_void  // HDIAGNOSTIC_RECORD* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("DiagnosticDataQuery.dll")]
public static extern int DdqGetDiagnosticRecordPage(IntPtr hSession, IntPtr searchCriteria, uint offset, uint pageRecordCount, long baseRowId, IntPtr hRecord);
"@
$api = Add-Type -MemberDefinition $sig -Name 'DiagnosticDataQuery_DdqGetDiagnosticRecordPage' -Namespace Win32 -PassThru
# $api::DdqGetDiagnosticRecordPage(hSession, searchCriteria, offset, pageRecordCount, baseRowId, hRecord)
#uselib "DiagnosticDataQuery.dll"
#func global DdqGetDiagnosticRecordPage "DdqGetDiagnosticRecordPage" sptr, sptr, sptr, sptr, sptr, sptr
; DdqGetDiagnosticRecordPage hSession, varptr(searchCriteria), offset, pageRecordCount, baseRowId, hRecord   ; 戻り値は stat
; hSession : HDIAGNOSTIC_DATA_QUERY_SESSION -> "sptr"
; searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA* -> "sptr"
; offset : DWORD -> "sptr"
; pageRecordCount : DWORD -> "sptr"
; baseRowId : LONGLONG -> "sptr"
; hRecord : HDIAGNOSTIC_RECORD* out -> "sptr"
; ※HSP3.7は int64 引数(64bit値渡し)に非対応です。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "DiagnosticDataQuery.dll"
#cfunc global DdqGetDiagnosticRecordPage "DdqGetDiagnosticRecordPage" sptr, var, int, int, int64, sptr
; res = DdqGetDiagnosticRecordPage(hSession, searchCriteria, offset, pageRecordCount, baseRowId, hRecord)
; hSession : HDIAGNOSTIC_DATA_QUERY_SESSION -> "sptr"
; searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA* -> "var"
; offset : DWORD -> "int"
; pageRecordCount : DWORD -> "int"
; baseRowId : LONGLONG -> "int64"
; hRecord : HDIAGNOSTIC_RECORD* out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。
出力引数:
; HRESULT DdqGetDiagnosticRecordPage(HDIAGNOSTIC_DATA_QUERY_SESSION hSession, DIAGNOSTIC_DATA_SEARCH_CRITERIA* searchCriteria, DWORD offset, DWORD pageRecordCount, LONGLONG baseRowId, HDIAGNOSTIC_RECORD* hRecord)
#uselib "DiagnosticDataQuery.dll"
#cfunc global DdqGetDiagnosticRecordPage "DdqGetDiagnosticRecordPage" intptr, var, int, int, int64, intptr
; res = DdqGetDiagnosticRecordPage(hSession, searchCriteria, offset, pageRecordCount, baseRowId, hRecord)
; hSession : HDIAGNOSTIC_DATA_QUERY_SESSION -> "intptr"
; searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA* -> "var"
; offset : DWORD -> "int"
; pageRecordCount : DWORD -> "int"
; baseRowId : LONGLONG -> "int64"
; hRecord : HDIAGNOSTIC_RECORD* out -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	diagnosticdataquery = windows.NewLazySystemDLL("DiagnosticDataQuery.dll")
	procDdqGetDiagnosticRecordPage = diagnosticdataquery.NewProc("DdqGetDiagnosticRecordPage")
)

// hSession (HDIAGNOSTIC_DATA_QUERY_SESSION), searchCriteria (DIAGNOSTIC_DATA_SEARCH_CRITERIA*), offset (DWORD), pageRecordCount (DWORD), baseRowId (LONGLONG), hRecord (HDIAGNOSTIC_RECORD* out)
r1, _, err := procDdqGetDiagnosticRecordPage.Call(
	uintptr(hSession),
	uintptr(searchCriteria),
	uintptr(offset),
	uintptr(pageRecordCount),
	uintptr(baseRowId),
	uintptr(hRecord),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function DdqGetDiagnosticRecordPage(
  hSession: THandle;   // HDIAGNOSTIC_DATA_QUERY_SESSION
  searchCriteria: Pointer;   // DIAGNOSTIC_DATA_SEARCH_CRITERIA*
  offset: DWORD;   // DWORD
  pageRecordCount: DWORD;   // DWORD
  baseRowId: Int64;   // LONGLONG
  hRecord: Pointer   // HDIAGNOSTIC_RECORD* out
): Integer; stdcall;
  external 'DiagnosticDataQuery.dll' name 'DdqGetDiagnosticRecordPage';
result := DllCall("DiagnosticDataQuery\DdqGetDiagnosticRecordPage"
    , "Ptr", hSession   ; HDIAGNOSTIC_DATA_QUERY_SESSION
    , "Ptr", searchCriteria   ; DIAGNOSTIC_DATA_SEARCH_CRITERIA*
    , "UInt", offset   ; DWORD
    , "UInt", pageRecordCount   ; DWORD
    , "Int64", baseRowId   ; LONGLONG
    , "Ptr", hRecord   ; HDIAGNOSTIC_RECORD* out
    , "Int")   ; return: HRESULT
●DdqGetDiagnosticRecordPage(hSession, searchCriteria, offset, pageRecordCount, baseRowId, hRecord) = DLL("DiagnosticDataQuery.dll", "int DdqGetDiagnosticRecordPage(void*, void*, dword, dword, int64, void*)")
# 呼び出し: DdqGetDiagnosticRecordPage(hSession, searchCriteria, offset, pageRecordCount, baseRowId, hRecord)
# hSession : HDIAGNOSTIC_DATA_QUERY_SESSION -> "void*"
# searchCriteria : DIAGNOSTIC_DATA_SEARCH_CRITERIA* -> "void*"
# offset : DWORD -> "dword"
# pageRecordCount : DWORD -> "dword"
# baseRowId : LONGLONG -> "int64"
# hRecord : HDIAGNOSTIC_RECORD* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。