Funzione PerfDecrementULongCounterValue (perflib.h)

Articolo
03/01/2024

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

Sintassi

ULONG PerfDecrementULongCounterValue(
  [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 dallo strumento CTRPP . Per il nome della variabile, vedere l'attributo simbolo dell'elemento provider .

Windows Vista: La funzione PerfStartProvider restituisce l'handle.

[in] Instance

Struttura PERF_COUNTERSET_INSTANCE contenente 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 contatore e deve corrispondere al membro CounterId di una delle strutture PERF_COUNTER_INFO nel blocco dell'istanza. Usare la costante ID contatore generata dallo strumento CTRPP . Per il nome della costante, vedere l'attributo simbolo dell'elemento contatore .

Windows Vista: La costante ID contatore non è disponibile.

[in] Value

Valore in base al quale decrerere il contatore.

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 di praticità per decrementare i dati dei contatori non elaborati. Per decrerere i dati del contatore non elaborati, usare il membro Offset della struttura PERF_COUNTER_INFO per accedere ai dati del contatore non elaborati per un contatore specifico. Il blocco di struttura PERF_COUNTERSET_INSTANCE contiene una o più strutture di informazioni contatori.

Utilizzare la funzione PerfSetULongCounterValue per impostare inizialmente il valore del contatore.

Si noti che il valore del contatore verrà sottoflow quando il valore del contatore decrementa zero.

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

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongCounterValue

Condividi tramite