Funzione PerfQueryCounterSetRegistrationInfo (perflib.h)

Articolo
08/25/2023

Ottiene informazioni su un set di contatori nel sistema specificato.

Sintassi

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

Parametri

[in, optional] szMachine

Nome del computer per cui ottenere le informazioni sul set di contatori specificato dal parametro pCounterSet . Se NULL, la funzione recupera informazioni sul set di contatori specificato per il computer locale.

[in] pCounterSetId

Identificatore del set di contatori del set di contatori per il quale si desidera ottenere informazioni.

requestCode

Tipo di informazioni da ottenere sul set di contatori. Per un elenco di valori possibili, vedere PerfRegInfoType .

requestLangId

Identificatore delle impostazioni locali preferite per le stringhe che contengono le informazioni richieste se requestCode è PERF_REG_COUNTERSET_NAME_STRING,

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS o

PERF_REG_COUNTER_HELP_STRINGS.

Identificatore del contatore per il quale si desiderano dati, se requestCode è PERF_REG_COUNTER_STRUCT.

Impostare su 0 per tutti gli altri valori di requestCode.

[out, optional] pbRegInfo

Puntatore a un buffer sufficiente per ricevere la quantità di dati specificati dal parametro cbRegInfo in byte. Può essere

NULL se cbRegInfo è 0.

cbRegInfo

Dimensioni del buffer specificato dal parametro pbRegInfo in byte.

[out] pcbRegInfoActual

Dimensioni del buffer effettivamente necessarie per ottenere le informazioni sul set di contatori. Il significato dipende dal valore che la funzione

Restituisce.

Valore restituito dalla funzione	Significato di pcbRegInfoActual
ERROR_SUCCESS	Numero di byte di informazioni sul set di contatori specificato archiviato nel buffer specificato da pbRegInfo .
ERROR_NOT_ENOUGH_MEMORY	The dimensioni del buffer necessario per archiviare le informazioni sul contatore impostato nel computer specificato, in byte. Ingrandire il buffer all'oggetto richiesto dimensioni e chiamare di nuovo la funzione.
Altro	Il valore non è definito e non deve essere usato.

Valore restituito dalla funzione

Significato di pcbRegInfoActual

ERROR_SUCCESS

Numero di

byte di informazioni sul set di contatori specificato archiviato nel buffer specificato da pbRegInfo .

ERROR_NOT_ENOUGH_MEMORY

The

dimensioni del buffer necessario per archiviare le informazioni sul contatore impostato nel computer specificato, in byte. Ingrandire il buffer all'oggetto richiesto

dimensioni e chiamare di nuovo la funzione.

Altro

Il valore non è definito e non deve essere usato.

Valore restituito

Codice restituito	Descrizione
ERROR_SUCCESS	La funzione ha archiviato tutte le informazioni sul contatore impostato nel buffer specificato da pbRegInfo . Valore che pcbRegInfoActual punta a indica la quantità di informazioni effettivamente archiviate nel buffer, in byte.
ERROR_NOT_ENOUGH_MEMORY	Il buffer specificato da pbRegInfo non è sufficiente per archiviare tutte le informazioni sul set di contatori. Valore che pcbRegInfoActual punta a indica le dimensioni del buffer necessarie per archiviare tutte le informazioni. Ingrandire il buffer all'oggetto richiesto dimensioni e chiamare di nuovo la funzione.

Per altri tipi di errori, il valore restituito è un codice di errore di sistema.

Commenti

Vedere PerfRegInfoType per i tipi di dati che è possibile richiedere e

i formati dei dati forniti per ogni tipo di richiesta.

Requisiti


Client minimo supportato	Windows 10 versione 1607 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	perflib.h
Libreria	AdvAPI32.lib
DLL	AdvAPI32.dll

Condividi tramite