Fonction DdqGetDiagnosticRecordPage (diagnosticdataquery.h)

Article
02/29/2024

Extrait une page (lot) d’enregistrements filtrés. Le filtrage sur les enregistrements retournés est effectué en interne à l’aide des paramètres d’entrée DIAGNOSTIC_DATA_SEARCH_CRITERIA searchCriteria, pageRecordCount, offset et baseRowId.

Syntaxe

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

Paramètres

hSession

Type : HANDLE Handle dans la session de requête de données de diagnostic.

searchCriteria

Type : DIAGNOSTIC_DATA_SEARCH_CRITERIA* Pointeur vers la ressource qui contient les critères de recherche pour cette opération. Cette ressource contient des critères tels que les producteurs, les catégories et les étiquettes.

offset

Type : UINT32 Filtre les résultats en retournant des enregistrements avec rowId qui commencent au décalage par rapport à baseRowId.

pageRecordCount

Type : UINT32 Nombre d’enregistrements dans une page d’enregistrement souhaitée

baseRowId

Type : INT64 Filtre les nouveaux enregistrements en retournant uniquement les enregistrements dont la valeur rowId est inférieure ou égale à baseRowId (cela est utile si le code d’interrogation souhaite limiter les résultats aux seuls événements disponibles au moment de l’appel DdqGetDiagnosticRecordStats. Le paramètre maxRowId peut être utilisé comme baseRowId). Aucun filtrage n’est appliqué si –1 est passé pour baseRowId.

hRecord

Type : HANDLE* Ce paramètre de sortie est un pointeur vers le handle de la ressource qui contient la liste des enregistrements correspondants.

Valeur retournée

Type : HRESULT retourne S_OK en cas d’achèvement réussi.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 2004 (10.0 ; Build 19041)
Serveur minimal pris en charge	Windows Server, version 2004 (10.0 ; Build 19041)
En-tête	diagnosticdataquery.h

Partager via