PdhSetQueryTimeRange, fonction (pdh.h)

Limite les exemples que vous pouvez lire à partir d’un fichier journal à ceux inclus dans l’intervalle de temps spécifié.

Syntaxe

PDH_FUNCTION PdhSetQueryTimeRange(
  [in] PDH_HQUERY     hQuery,
  [in] PPDH_TIME_INFO pInfo
);

Paramètres

[in] hQuery

Gérer la requête. La fonction PdhOpenQuery retourne ce handle.

[in] pInfo

Structure PDH_TIME_INFO qui spécifie l’intervalle de temps. Spécifiez l’heure comme heure du fichier local. L’heure de fin doit être supérieure à l’heure de début. Vous pouvez spécifier 0 pour l’heure de début et la valeur maximale de 64 bits pour l’heure de fin si vous souhaitez lire tous les enregistrements.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est un code d’erreur système ou un code d’erreur PDH. Voici les valeurs possibles.

Code de retour	Description
PDH_INVALID_HANDLE	Le handle de requête n’est pas valide.
PDH_INVALID_ARGUMENT	La valeur de l’intervalle de temps de fin doit être supérieure à la valeur de l’intervalle de temps de début.

Remarques

Lorsque la fin de l’intervalle de temps spécifié ou la fin du fichier journal est atteinte, la fonction PdhCollectQueryData retourne PDH_NO_MORE_DATA.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pdh.h
Bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PdhCollectQueryData

PdhGetDataSourceTimeRange

PdhOpenQuery