Fonction PerfOpenQueryHandle (perflib.h)

Article
03/01/2024

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