PdhGetDataSourceTimeRangeA, fonction (pdh.h)

Article
11/20/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.

Pour utiliser des handles vers 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. Par conséquent, 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 de retour

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.

Retourner le code	Description
PDH_INVALID_ARGUMENT	Un paramètre n’est pas valide ou n’est pas correctement 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

Note

L’en-tête pdh.h définit PdhGetDataSourceTimeRange comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	pdh.h
bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange

Partager via