PdhGetDataSourceTimeRangeH, fonction (pdh.h)

Article
03/04/2024

Détermine l’intervalle de temps, le nombre d’entrées et, le cas échéant, la taille de la mémoire tampon contenant les données de performances de la source d’entrée spécifiée.

Cette fonction est identique à la fonction PdhGetDataSourceTimeRange , sauf qu’elle prend en charge l’utilisation de handles pour les sources de données.

Syntaxe

PDH_FUNCTION PdhGetDataSourceTimeRangeH(
  [in]  PDH_HLOG       hDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Paramètres

[in] hDataSource

Gérez vers une source de données retournée par la fonction PdhBindInputDataSource .

[out] pdwNumEntries

Nombre de structures dans la mémoire tampon pInfo . Cette fonction collecte des informations pour un seul intervalle de temps, de sorte que la valeur est généralement 1 ou zéro si une erreur s’est produite.

[out] pInfo

Structure PDH_TIME_INFO qui reçoit l’intervalle de temps. Les informations couvrent tous les fichiers journaux liés.

[in] pdwBufferSize

Taille de la structure PDH_TIME_INFO , en octets.

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_ARGUMENT	Un paramètre n’est pas valide ou est mal mis en forme.
PDH_INVALID_HANDLE	Le handle de compteur n’est pas valide.
PDH_DATA_SOURCE_IS_REAL_TIME	La source de données actuelle est une source de données en temps réel.

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

PdhBindInputDataSource

Partager via