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 |
|---|---|
|
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 |