PerfDecrementULongCounterValue-Funktion (perflib.h)

Artikel
03/01/2024

Dekrementiert den Wert eines Zählers, dessen Wert eine 4-Byte-Ganzzahl ohne Vorzeichen ist. Anbieter verwenden diese Funktion.

Syntax

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

Parameter

[in] Provider

Das Handle des Anbieters. Verwenden Sie die Handle-Variable, die das CTRPP-Tool für Sie generiert hat. Den Namen der Variablen finden Sie im Symbol-Attribut des provider-Elements .

Windows Vista: Die PerfStartProvider-Funktion gibt das Handle zurück.

[in] Instance

Eine PERF_COUNTERSET_INSTANCE-Struktur, die den Zählersatz instance enthält. Die PerfCreateInstance-Funktion gibt diesen Zeiger zurück.

[in] CounterId

Bezeichner, der den zu aktualisierenden Zähler im instance block eindeutig identifiziert. Der Bezeichner wird im id-Attribut des counter-Elements definiert und muss mit dem CounterId-Member einer der PERF_COUNTER_INFO-Strukturen im instance-Block übereinstimmen. Verwenden Sie die Zähler-ID-Konstante, die das CTRPP-Tool für Sie generiert hat. Den Namen der Konstanten finden Sie im Symbol-Attribut des Counter-Elements .

Windows Vista: Die Zähler-ID-Konstante ist nicht verfügbar.

[in] Value

Wert, um den der Zähler verringert werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Hinweise

Dies ist eine Komfortfunktion zum Dekrementieren von Unformatierten Zählerdaten. Um die Rohdaten des Zählers selbst zu dekrementieren, verwenden Sie den Offset-Member der PERF_COUNTER_INFO-Struktur , um auf die Rohdaten des Indikators für einen bestimmten Indikator zuzugreifen. Der PERF_COUNTERSET_INSTANCE-Strukturblock enthält mindestens eine Indikatorinformationsstruktur.

Verwenden Sie die PerfSetULongCounterValue-Funktion , um den Zählerwert zunächst festzulegen.

Beachten Sie, dass der Zählerwert unterläuft, wenn der Zählerwert über null dekrementiert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	perflib.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongCounterValue

Freigeben über