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

형식: 진단 데이터 쿼리 세션에 대한 HANDLE 핸들 입니다.

searchCriteria

형식: DIAGNOSTIC_DATA_SEARCH_CRITERIA* 이 작업에 대한 검색 조건을 포함하는 리소스에 대한 포인터입니다. 이 리소스에는 생산자, 범주 및 태그와 같은 조건이 포함됩니다.

offset

형식: UINT32 baseRowId의 오프셋에서 시작하는 rowId가 있는 레코드를 반환하여 결과를 필터링합니다.

pageRecordCount

형식: UINT32 원하는 레코드 페이지의 레코드 수

baseRowId

형식: INT64 rowId 값이 baseRowId보다 작거나 같은 레코드만 반환하여 새 레코드를 필터링합니다(쿼리 코드가 DdqGetDiagnosticRecordStats 호출 시 사용 가능한 이벤트로만 결과를 제한하려는 경우에 유용합니다. maxRowId 매개 변수를 baseRowId로 사용할 수 있습니다.) baseRowId에 대해 –1을 전달하면 필터링이 적용되지 않습니다.

hRecord

형식: HANDLE* 이 출력 매개 변수는 일치하는 레코드 목록을 포함하는 리소스의 핸들에 대한 포인터입니다.

반환 값

형식: HRESULT 가 성공적으로 완료되면 S_OK 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 2004(10.0; 빌드 19041)
지원되는 최소 서버	Windows Server 버전 2004(10.0; 빌드 19041)
머리글	diagnosticdataquery.h