DdqGetDiagnosticRecordPage 関数 (diagnosticdataquery.h)

  • [アーティクル]

フィルター処理されたレコードのページ (バッチ) をフェッチします。 返されるレコードのフィルター処理は、searchCriteria、pageRecordCount、offset、baseRowId DIAGNOSTIC_DATA_SEARCH_CRITERIA入力パラメーターを使用して内部的に実行されます。

構文

HRESULT DdqGetDiagnosticRecordPage(
  HDIAGNOSTIC_DATA_QUERY_SESSION          hSession,
  DIAGNOSTIC_DATA_SEARCH_CRITERIA * const searchCriteria,
  UINT32                                  offset,
  UINT32                                  pageRecordCount,
  INT64                                   baseRowId,
  HDIAGNOSTIC_RECORD                      *hRecord
);

パラメーター

hSession

種類: 診断 データ クエリ セッションへのハンドル。

searchCriteria

種類: DIAGNOSTIC_DATA_SEARCH_CRITERIA* この操作の検索条件を含むリソースへのポインター。 このリソースには、プロデューサー、カテゴリ、タグなどの条件が含まれています。

offset

型: UINT32 baseRowId からのオフセットから始まる rowId を持つレコードを返すことによって結果をフィルター処理します。

pageRecordCount

種類: UINT32 目的のレコード ページ内のレコードの数

baseRowId

種類: INT64 baseRowId 以下の rowId 値を持つレコードのみを返すことによって、新しいレコードをフィルター処理します (これは、コードのクエリで DdqGetDiagnosticRecordStats 呼び出し時に使用可能だったイベントのみに結果を制限する場合に便利です。maxRowId パラメーターは baseRowId として使用できます)。 baseRowId に –1 が渡された場合、フィルター処理は適用されません。

hRecord

型: HANDLE* この出力パラメーターは、一致するレコードの一覧を含むリソースのハンドルへのポインターです。

戻り値

型: HRESULT 正常に完了すると、S_OKが返されます。

要件

要件 値
サポートされている最小のクライアント Windows 10バージョン 2004 (10.0;ビルド 19041)
サポートされている最小のサーバー Windows Server バージョン 2004 (10.0;ビルド 19041)
Header diagnosticdataquery.h