Fonction PerfQueryInstance (perflib.h)

Article
08/25/2023

Récupère un pointeur vers le jeu de compteurs spécifié instance. Les fournisseurs utilisent cette fonction.

Syntaxe

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

Paramètres

[in] ProviderHandle

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

GUID qui identifie de manière unique le jeu de compteurs que vous souhaitez interroger. Il s’agit du même GUID spécifié dans l’attribut guid de l’élément counterSet . Utilisez la variable GUID que l’outil CTRPP a générée pour vous. Pour obtenir le nom de la variable, consultez l’attribut symbol de l’élément counterSet .

Windows Vista : La variable GUID n’est pas disponible.

[in] Name

Chaîne Unicode terminée par null qui contient le nom du jeu de compteurs instance que vous souhaitez récupérer.

[in] Id

Identificateur unique du jeu de compteurs instance que vous souhaitez récupérer.

Valeur retournée

Structure PERF_COUNTERSET_INSTANCE qui contient le jeu de compteurs instance ou NULL si le instance n’existe pas.

Cette fonction retourne la valeur NULL si une erreur s’est produite. Pour déterminer l’erreur qui s’est produite, appelez GetLastError.

Notes

Utilisez les mêmes instance nom et identificateur que ceux que vous avez utilisés lors de l’appel de PerfCreateInstance pour récupérer un instance spécifique du jeu de compteurs.

Les fournisseurs doivent mettre en cache le pointeur vers le instance lorsqu’ils créent le instance au lieu d’appeler cette fonction pour récupérer le pointeur.

Spécifications


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

Voir aussi

PerfCreateInstance

Partager via