Partager via


PdhGetDataSourceTimeRangeA, fonction (pdh.h)

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.

Pour utiliser des handles dans des sources de données, utilisez la fonction PdhGetDataSourceTimeRangeH .

Syntaxe

PDH_FUNCTION PdhGetDataSourceTimeRangeA(
  [in]  LPCSTR         szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Paramètres

[in] szDataSource

Chaîne terminée par null qui spécifie le nom d’un fichier journal à partir duquel les informations d’intervalle de temps sont récupérées.

[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.

[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.

Remarques

Notes

L’en-tête pdh.h définit PdhGetDataSourceTimeRange en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange