PerfQueryCounterSetRegistrationInfo-Funktion (perflib.h)

Artikel
08/25/2023

Ruft Informationen zu einem Leistungsindikatorsatz im angegebenen System ab.

Syntax

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

Parameter

[in, optional] szMachine

Der Name des Computers, für den die Informationen zum Leistungsindikatorsatz abgerufen werden sollen, den der pCounterSet-Parameter angibt. Wenn NULL, ruft die Funktion Informationen zum angegebenen Leistungsindikatorsatz für den lokalen Computer ab.

[in] pCounterSetId

Der Indikatorsatzbezeichner des Zählersatzes, für den Sie Informationen abrufen möchten.

requestCode

Der Typ der Informationen, die Sie über den Leistungsindikatorsatz abrufen möchten. Eine Liste der möglichen Werte finden Sie unter PerfRegInfoType .

requestLangId

Der bevorzugte Gebietsschemabezeichner für die Zeichenfolgen, die die angeforderten Informationen enthalten, wenn requestCodePERF_REG_COUNTERSET_NAME_STRING ist.

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS oder

PERF_REG_COUNTER_HELP_STRINGS.

Der Indikatorbezeichner des Leistungsindikators, für den Sie Daten benötigen, wenn requestCodePERF_REG_COUNTER_STRUCT ist.

Legen Sie für alle anderen Werte von requestCode auf 0 fest.

[out, optional] pbRegInfo

Zeiger auf einen Puffer, der groß genug ist, um die vom cbRegInfo-Parameter angegebene Datenmenge in Bytes zu empfangen. Kann sein

NULL, wenn cbRegInfo 0 ist.

cbRegInfo

Die Größe des Puffers, den der parameter pbRegInfo in Byte angibt.

[out] pcbRegInfoActual

Die Größe des Puffers, der tatsächlich erforderlich ist, um die Informationen zum Leistungsindikatorsatz abzurufen. Die Bedeutung hängt vom Wert ab, den die Funktion

Gibt.

Funktionsrückgabewert	Bedeutung von pcbRegInfoActual
ERROR_SUCCESS	Die Anzahl von Byte von Informationen über den angegebenen Leistungsindikatorsatz, den die Funktion in dem puffer gespeichert hat, den pbRegInfo angegeben hat.
ERROR_NOT_ENOUGH_MEMORY	The Größe des Puffers, der zum Speichern der Informationen zum Zählersatz auf dem angegebenen Computer in Byte erforderlich ist. Vergrößern des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf.
Andere	Der Wert ist undefiniert und sollte nicht verwendet werden.

Funktionsrückgabewert

Bedeutung von pcbRegInfoActual

ERROR_SUCCESS

Die Anzahl von

Byte von Informationen über den angegebenen Leistungsindikatorsatz, den die Funktion in dem puffer gespeichert hat, den pbRegInfo angegeben hat.

ERROR_NOT_ENOUGH_MEMORY

The

Größe des Puffers, der zum Speichern der Informationen zum Zählersatz auf dem angegebenen Computer in Byte erforderlich ist. Vergrößern des Puffers auf den erforderlichen

größe, und rufen Sie die Funktion erneut auf.

Andere

Der Wert ist undefiniert und sollte nicht verwendet werden.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Funktion hat erfolgreich alle Informationen zum Zählersatz in dem Puffer gespeichert, den pbRegInfo angegeben hat. Der Wert, auf den pcbRegInfoActual zeigt, gibt die Menge der tatsächlich im Puffer gespeicherten Informationen in Bytes an.
ERROR_NOT_ENOUGH_MEMORY	Der von pbRegInfo angegebene Puffer war nicht groß genug, um alle Informationen zum Leistungsindikatorsatz zu speichern. Der Wert, auf den pcbRegInfoActual zeigt, gibt die Größe des Puffers an, der zum Speichern aller Informationen erforderlich ist. Vergrößern des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf.

Bei anderen Fehlertypen ist der Rückgabewert ein Systemfehlercode.

Hinweise

Informationen zu den Datentypen, die Sie anfordern können, finden Sie unter PerfRegInfoType .

die Formate der Daten, die für jeden Anforderungstyp bereitgestellt werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	perflib.h
Bibliothek	AdvAPI32.lib
DLL	AdvAPI32.dll

Freigeben über