Función DdqGetDiagnosticRecordPage (diagnosticdataquery.h)

  • Artículo

Captura una página (lote) de registros filtrados. El filtrado de los registros devueltos se realiza internamente mediante los parámetros de entrada DIAGNOSTIC_DATA_SEARCH_CRITERIA searchCriteria, pageRecordCount, offset y baseRowId.

Sintaxis

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

Parámetros

hSession

Tipo: IDENTIFICADOR de la sesión de consulta de datos de diagnóstico.

searchCriteria

Tipo: DIAGNOSTIC_DATA_SEARCH_CRITERIA* Puntero al recurso que contiene los criterios de búsqueda de esta operación. Este recurso contiene criterios como productores, categorías y etiquetas.

offset

Tipo: UINT32 Filtra los resultados devolviendo registros con rowId que comienzan en el desplazamiento desde baseRowId.

pageRecordCount

Tipo: UINT32 El número de registros de una página de registro deseada

baseRowId

Tipo: INT64 Filtra los registros nuevos devolviendo solo los registros con el valor rowId menor o igual que baseRowId (esto resulta útil si el código de consulta quiere limitar los resultados solo a eventos que estaban disponibles en el momento de la llamada a DdqGetDiagnosticRecordStats. El parámetro maxRowId se puede usar como baseRowId). No se aplica ningún filtrado si se pasa –1 para baseRowId.

hRecord

Tipo: HANDLE* Este parámetro de salida es un puntero al identificador del recurso que contiene la lista de registros coincidentes.

Valor devuelto

Tipo: HRESULT Devuelve S_OK al completarse correctamente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 2004 (10.0; Compilación 19041)
Servidor mínimo compatible Windows Server, versión 2004 (10.0; Compilación 19041)
Encabezado diagnosticdataquery.h