Funzione PerfEnumerateCounterSet (perflib.h)

Articolo
03/01/2024

Ottiene gli identificatori del set di contatori dei set di contatori registrati nell'oggetto

sistema specificato.

Gli identificatori del set di contatori sono identificatori univoci globali (GUID).

Sintassi

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

Parametri

[in, optional] szMachine

Nome del computer per cui ottenere gli identificatori del set di contatori. Se NULL, la funzione recupera gli identificatori del set di contatori per il computer locale.

[out, optional] pCounterSetIds

Puntatore a un buffer con spazio sufficiente per ricevere il numero di GUID specificati dal parametro cCounterSetIds . Può essere NULL se

cCounterSetIds è 0.

cCounterSetIds

Dimensione del buffer specificata dal parametro pCounterSetIds , misurata in GUID.

[out] pcCounterSetIdsActual

Dimensioni del buffer effettivamente necessarie per ottenere gli identificatori del set di contatori. Il significato dipende dal valore che la funzione

Restituisce.

Valore restituito dalla funzione	Significato di pcCounterSetIdsActual
ERROR_SUCCESS	Numero di GUID archiviata nel buffer specificato da pCounterSetIds .
ERROR_NOT_ENOUGH_MEMORY	The dimensioni (in GUID) del buffer richiesto. 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 pcCounterSetIdsActual

ERROR_SUCCESS

Numero di

GUID archiviata nel buffer specificato da pCounterSetIds .

ERROR_NOT_ENOUGH_MEMORY

The

dimensioni (in GUID) del buffer richiesto. 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 tutti gli identificatori del set di contenuto nel buffer specificato da pCounterSetIds . Valore che pcCounterSetIdsActual punta a indica il numero di identificatori di set di contatori effettivamente archiviati nel buffer.
ERROR_NOT_ENOUGH_MEMORY	Il buffer specificato da pCounterSetIds non è sufficiente per archiviare tutti gli identificatori del set di contatori per i set di contatori nel sistema specificato. Valore che pcCounterSetIdsActual punta a indica la dimensione del buffer necessaria per archiviare tutti gli identificatori del set di contatori. Ingrandire il buffer all'oggetto richiesto dimensioni e chiamare di nuovo la funzione.

Codice restituito

Descrizione

ERROR_SUCCESS

La funzione ha archiviato tutti gli identificatori del set di contenuto nel buffer specificato da pCounterSetIds . Valore che pcCounterSetIdsActual punta a indica il numero di identificatori di set di contatori effettivamente archiviati nel buffer.

ERROR_NOT_ENOUGH_MEMORY

Il buffer specificato da pCounterSetIds non è sufficiente per archiviare tutti gli identificatori del set di contatori per i set di contatori nel sistema specificato. Valore che pcCounterSetIdsActual punta a indica la dimensione del buffer necessaria per archiviare tutti gli identificatori del set di contatori. 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.

Requisiti

Requisito	Valore
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

Vedi anche

PerfEnumerateCounterSetInstances

Condividi tramite