Fonction PerfDeleteInstance (perflib.h)
Supprime une instance du jeu de compteurs créé par la fonction PerfCreateInstance. Les fournisseurs utilisent cette fonction.
Syntaxe
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
Paramètres
[in] Provider
Handle du fournisseur. Utilisez la variable handle que l’outil CTRPP a générée pour vous. Pour connaître le nom de la variable, consultez l’attribut symbol de l’élément provider .
Windows Vista : La fonction PerfStartProvider retourne le handle.
[in] InstanceBlock
Structure PERF_COUNTERSET_INSTANCE qui contient les instance du jeu de compteurs à supprimer.
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
Si le processus du fournisseur se termine de manière anormale, toutes les instances allouées sont libérées.
Le fournisseur détermine quand il supprime un instance. Si les données du compteur sont plus statiques, le fournisseur peut supprimer un instance au moment du nettoyage. Par exemple, le nombre de processeurs sur un ordinateur étant considéré comme statique, un fournisseur qui fournit des données de compteur pour les processeurs peut supprimer un instance pour chaque processeur sur l’ordinateur au moment du nettoyage. Pour les compteurs plus dynamiques, tels que les compteurs de disque ou de processus, les fournisseurs suppriment les instances en réponse à la suppression d’un périphérique USB ou à l’arrêt d’un processus.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | perflib.h |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |