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 |