Fonction PerfQueryCounterSetRegistrationInfo (perflib.h)

Article
08/25/2023

Obtient des informations sur un jeu de compteurs sur le système spécifié.

Syntaxe

ULONG PerfQueryCounterSetRegistrationInfo(
  [in, optional]  LPCWSTR         szMachine,
  [in]            LPCGUID         pCounterSetId,
                  PerfRegInfoType requestCode,
                  DWORD           requestLangId,
  [out, optional] LPBYTE          pbRegInfo,
                  DWORD           cbRegInfo,
  [out]           LPDWORD         pcbRegInfoActual
);

Paramètres

[in, optional] szMachine

Nom de la machine pour laquelle obtenir les informations sur le jeu de compteurs spécifié par le paramètre pCounterSet . Si la valeur est NULL, la fonction récupère des informations sur le jeu de compteurs spécifié pour l’ordinateur local.

[in] pCounterSetId

Identificateur du jeu de compteurs pour lequel vous souhaitez obtenir des informations.

requestCode

Type d’informations que vous souhaitez obtenir sur le jeu de compteurs. Pour obtenir la liste des valeurs possibles , consultez PerfRegInfoType .

requestLangId

Identificateur de paramètres régionaux préférés pour les chaînes qui contiennent les informations demandées si requestCode est PERF_REG_COUNTERSET_NAME_STRING,

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS ou

PERF_REG_COUNTER_HELP_STRINGS.

Identificateur du compteur pour lequel vous souhaitez des données, si requestCode est PERF_REG_COUNTER_STRUCT.

Définissez sur 0 pour toutes les autres valeurs de requestCode.

[out, optional] pbRegInfo

Pointeur vers une mémoire tampon suffisamment grande pour recevoir la quantité de données spécifiée par le paramètre cbRegInfo , en octets. Peut être

NULL si cbRegInfo a la valeur 0.

cbRegInfo

Taille de la mémoire tampon spécifiée par le paramètre pbRegInfo , en octets.

[out] pcbRegInfoActual

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

Retourne.

Valeur de retour de fonction	Signification de pcbRegInfoActual
ERROR_SUCCESS	Nombre de octets d’informations sur le jeu de compteurs spécifié que la fonction stockée dans la mémoire tampon spécifiée par pbRegInfo .
ERROR_NOT_ENOUGH_MEMORY	The taille de la mémoire tampon requise pour stocker les informations sur le compteur défini sur l’ordinateur spécifié, en octets. Agrandir la mémoire tampon pour qu’elle soit requise 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 fonction

Signification de pcbRegInfoActual

ERROR_SUCCESS

Nombre de

octets d’informations sur le jeu de compteurs spécifié que la fonction stockée dans la mémoire tampon spécifiée par pbRegInfo .

ERROR_NOT_ENOUGH_MEMORY

The

taille de la mémoire tampon requise pour stocker les informations sur le compteur défini sur l’ordinateur spécifié, en octets. Agrandir la mémoire tampon pour qu’elle soit requise

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é toutes les informations sur le compteur défini dans la mémoire tampon spécifiée par pbRegInfo . Valeur que pcbRegInfoActual pointe pour indiquer la quantité d’informations réellement stockées dans la mémoire tampon, en octets.
ERROR_NOT_ENOUGH_MEMORY	La mémoire tampon spécifiée par pbRegInfo n’était pas assez grande pour stocker toutes les informations sur le jeu de compteurs. La valeur vers laquelle pointe pcbRegInfoActual indique la taille de la mémoire tampon requise pour stocker toutes les informations. Agrandir la mémoire tampon pour qu’elle soit requise dimensionner et appeler à nouveau la fonction.

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

Notes

Consultez PerfRegInfoType pour connaître les types de données que vous pouvez demander et

formats des données fournies pour chaque type de requête.

Spécifications


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

Partager via