Partager via


PdhCloseQuery, fonction (pdh.h)

Ferme tous les compteurs contenus dans la requête spécifiée, ferme tous les handles liés à la requête et libère toute la mémoire associée à la requête.

Syntaxe

PDH_FUNCTION PdhCloseQuery(
  [in] PDH_HQUERY hQuery
);

Paramètres

[in] hQuery

Gérez la requête à fermer. Ce handle est retourné par la fonction PdhOpenQuery .

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur système ou un code d’erreur PDH.

Voici une valeur possible.

Code de retour Description
PDH_INVALID_HANDLE
Le handle de requête n’est pas valide.

Remarques

N’utilisez pas les handles de compteur associés à cette requête après avoir appelé cette fonction.

L’exemple suivant montre la syntaxe en cas d’appel de cette fonction à partir de Visual Basic.

PdhCloseQuery(
  ByVal QueryHandle as Long  
)
as Long

Exemples

Pour obtenir un exemple, consultez Navigation des compteurs de performances ou Lecture des données de performances à partir d’un fichier journal.

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

PdhOpenQuery