Partager via


Fonction PerfEnumerateCounterSet (perflib.h)

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

 

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