Funzione PerfSetULongCounterValue (perflib.h)

Articolo
03/05/2024

Aggiornamenti il valore di un contatore il cui valore è un intero senza segno a 4 byte. I provider usano questa funzione.

Sintassi

ULONG PerfSetULongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONG                     Value
);

Parametri

[in] Provider

Handle del provider. Usare la variabile handle generata automaticamente dallo strumento CTRPP . Per il nome della variabile, vedere l'attributo symbol dell'elemento provider .

Windows Vista: La funzione PerfStartProvider restituisce l'handle.

[in] Instance

Struttura PERF_COUNTERSET_INSTANCE che contiene l'istanza del set di contatori. La funzione PerfCreateInstance restituisce questo puntatore.

[in] CounterId

Identificatore che identifica in modo univoco il contatore da aggiornare nel blocco di istanze. L'identificatore è definito nell'attributo ID dell'elemento counter e deve corrispondere al membro CounterId di una delle strutture PERF_COUNTER_INFO nel blocco di istanze. Usare la costante ID contatore generata automaticamente dallo strumento CTRPP . Per il nome della costante, vedere l'attributo symbol dell'elemento counter .

Windows Vista: La costante ID contatore non è disponibile.

[in] Value

Nuovo valore del contatore a 4 byte.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Si tratta di una funzione utile per l'impostazione dei dati dei contatori non elaborati. Per aggiornare manualmente i dati dei contatori non elaborati, utilizzare il membro Offset della struttura PERF_COUNTER_INFO per accedere ai dati dei contatori non elaborati per un contatore specifico. Il blocco struttura PERF_COUNTERSET_INSTANCE contiene una o più strutture di informazioni sui contatori.

È possibile usare le funzioni PerfIncrementULongCounterValue e PerfDecrementULongCounterValue per incrementare o decrementare rispettivamente il valore del contatore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	perflib.h
Libreria	Advapi32.lib
DLL	Advapi32.dll

Vedi anche

PerfDecrementULongCounterValue

PerfIncrementULongCounterValue

PerfSetCounterRefValue

PerfSetULongLongCounterValue

Condividi tramite