Partager via


Fonction PerfOpenQueryHandle (perflib.h)

Crée un handle qui référence une requête sur le système spécifié. Une requête est une liste de spécifications de compteur.

Syntaxe

ULONG PerfOpenQueryHandle(
  [in, optional] LPCWSTR szMachine,
  [out]          HANDLE  *phQuery
);

Paramètres

[in, optional] szMachine

Nom de l’ordinateur pour lequel vous souhaitez obtenir le handle de requête.

[out] phQuery

Handle de la requête. Appelez PerfCloseQueryHandle pour fermer ths handle lorsque vous n’en avez plus besoin.

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.

Remarques

Utilisez PerfAddCounters et PerfDeleteCounters pour ajouter ou supprimer des spécifications de compteur à la liste. Utilisez PerfQueryCounterInfo pour obtenir les spécifications de compteur actuellement dans la liste et pour déterminer les index auxquels les données de chaque compteur seront retournées par PerfQueryCounterData. Utilisez PerfQueryCounterData pour récupérer les valeurs des compteurs qui correspondent aux spécifications du compteur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête perflib.h
Bibliothèque AdvAPI32.lib
DLL AdvAPI32.dll

Voir aussi

PerfAddCounters

PerfCloseQueryHandle

PerfDeleteCounters

PerfQueryCounterData

PerfQueryCounterInfo