Fonction PerfEnumerateCounterSet (perflib.h)

Article
08/25/2023

Obtient les identificateurs de jeu de compteurs des jeux de compteurs qui sont inscrits sur le

système spécifié.

Les identificateurs de jeu de compteurs sont des identificateurs globaux uniques (GUID).

Syntaxe

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

Paramètres

[in, optional] szMachine

Nom de l’ordinateur pour lequel obtenir les identificateurs du jeu de compteurs. Si la valeur est NULL, la fonction récupère les identificateurs du jeu de compteurs pour l’ordinateur local.

[out, optional] pCounterSetIds

Pointeur vers une mémoire tampon qui a suffisamment d’espace pour recevoir le nombre de GUID spécifiés par le paramètre cCounterSetIds . Peut être NULL si

cCounterSetIds est 0.

cCounterSetIds

Taille de la mémoire tampon spécifiée par le paramètre pCounterSetIds , mesurée en GUID.

[out] pcCounterSetIdsActual

Taille de la mémoire tampon réellement requise pour obtenir les identificateurs du jeu de compteurs. La signification dépend de la valeur que la fonction

Retourne.

Valeur de retour de la fonction	Signification de pcCounterSetIdsActual
ERROR_SUCCESS	Nombre de GUID que la fonction a stockés dans la mémoire tampon spécifiée par pCounterSetIds .
ERROR_NOT_ENOUGH_MEMORY	The taille (en GUID) de la mémoire tampon requise. Agrandir la mémoire tampon à l’élément requis dimensionner et appeler à nouveau la fonction.
Autres	La valeur n’est pas définie et ne doit pas être utilisée.

Valeur de retour de la fonction

Signification de pcCounterSetIdsActual

ERROR_SUCCESS

Nombre de

GUID que la fonction a stockés dans la mémoire tampon spécifiée par pCounterSetIds .

ERROR_NOT_ENOUGH_MEMORY

The

taille (en GUID) de la mémoire tampon requise. Agrandir la mémoire tampon à l’élément requis

dimensionner et appeler à nouveau la fonction.

Autres

La valeur n’est pas définie et ne doit pas être utilisée.

Valeur retournée

Code de retour	Description
ERROR_SUCCESS	La fonction a correctement stocké tous les identificateurs de jeu de contenu dans la mémoire tampon spécifiée par pCounterSetIds . La valeur vers laquelle pointe pcCounterSetIdsActual indique le nombre d’identificateurs de jeu de compteurs réellement stockés dans la mémoire tampon.
ERROR_NOT_ENOUGH_MEMORY	La mémoire tampon spécifiée par pCounterSetIds n’était pas suffisamment grande pour stocker tous les identificateurs de jeu de compteurs pour les jeux de compteurs sur le système spécifié. La valeur vers laquelle pointe pcCounterSetIdsActual indique la taille de la mémoire tampon requise pour stocker tous les identificateurs du jeu de compteurs. Agrandir la mémoire tampon à l’élément requis dimensionner et appeler à nouveau la fonction.

Code de retour

Description

ERROR_SUCCESS

La fonction a correctement stocké tous les identificateurs de jeu de contenu dans la mémoire tampon spécifiée par pCounterSetIds . La valeur vers laquelle pointe pcCounterSetIdsActual indique le nombre d’identificateurs de jeu de compteurs réellement stockés dans la mémoire tampon.

ERROR_NOT_ENOUGH_MEMORY

La mémoire tampon spécifiée par pCounterSetIds n’était pas suffisamment grande pour stocker tous les identificateurs de jeu de compteurs pour les jeux de compteurs sur le système spécifié. La valeur vers laquelle pointe pcCounterSetIdsActual indique la taille de la mémoire tampon requise pour stocker tous les identificateurs du jeu de compteurs. Agrandir la mémoire tampon à l’élément requis

dimensionner et appeler à nouveau la fonction.

Pour les autres types de défaillances, la valeur de retour est un code d’erreur système.

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

Voir aussi

PerfEnumerateCounterSetInstances

Share via