Partager via


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