PerfEnumerateCounterSet-Funktion (perflib.h)

Artikel
03/06/2024

Ruft die Indikatorensatzbezeichner der Indikatorensätze ab, die für den

angegebenes System.

Indikatorensatzbezeichner sind global eindeutige Bezeichner (GUIDs).

Syntax

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

Parameter

[in, optional] szMachine

Der Name des Computers, für den die Indikatorensatzbezeichner abgerufen werden sollen. Bei NULL ruft die Funktion die Indikatorensatzbezeichner für den lokalen Computer ab.

[out, optional] pCounterSetIds

Ein Zeiger auf einen Puffer, der über genügend Speicherplatz verfügt, um die Anzahl von GUIDs zu empfangen, die der cCounterSetIds-Parameter angibt. Kann NULL sein, wenn

cCounterSetIds ist 0.

cCounterSetIds

Die Größe des Puffers, den der pCounterSetIds-Parameter angibt, gemessen in GUIDs.

[out] pcCounterSetIdsActual

Die Größe des Puffers, die zum Abrufen der Indikatorensatzbezeichner tatsächlich erforderlich ist. Die Bedeutung hängt vom Wert der Funktion ab.

Gibt.

Funktionsrückgabewert	Bedeutung von pcCounterSetIdsActual
ERROR_SUCCESS	Die Anzahl von GUIDs, die die Funktion im Puffer gespeichert hat, den pCounterSetIds angegeben hat.
ERROR_NOT_ENOUGH_MEMORY	The Größe (in GUIDs) des erforderlichen Puffers. Vergrößern Des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf.
Sonstiges	Der Wert ist undefiniert und sollte nicht verwendet werden.

Funktionsrückgabewert

Bedeutung von pcCounterSetIdsActual

ERROR_SUCCESS

Die Anzahl von

GUIDs, die die Funktion im Puffer gespeichert hat, den pCounterSetIds angegeben hat.

ERROR_NOT_ENOUGH_MEMORY

The

Größe (in GUIDs) des erforderlichen Puffers. Vergrößern Des Puffers auf den erforderlichen

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

Sonstiges

Der Wert ist undefiniert und sollte nicht verwendet werden.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Funktion speicherte erfolgreich alle Inhaltssatzbezeichner in dem Puffer, den pCounterSetIds angegeben hat. Der Wert, auf den pcCounterSetIdsActual verweist, gibt die Anzahl der Indikatorensatzbezeichner an, die tatsächlich im Puffer gespeichert sind.
ERROR_NOT_ENOUGH_MEMORY	Der puffer, den pCounterSetIds angegeben hat, war nicht groß genug, um alle Indikatorensatzbezeichner für die Indikatorensätze im angegebenen System zu speichern. Der Wert, auf den pcCounterSetIdsActual verweist, gibt die Größe des Puffers an, der zum Speichern aller Indikatorensatzbezeichner erforderlich ist. Vergrößern Des Puffers auf den erforderlichen größe, und rufen Sie die Funktion erneut auf.

Rückgabecode

Beschreibung

ERROR_SUCCESS

Die Funktion speicherte erfolgreich alle Inhaltssatzbezeichner in dem Puffer, den pCounterSetIds angegeben hat. Der Wert, auf den pcCounterSetIdsActual verweist, gibt die Anzahl der Indikatorensatzbezeichner an, die tatsächlich im Puffer gespeichert sind.

ERROR_NOT_ENOUGH_MEMORY

Der puffer, den pCounterSetIds angegeben hat, war nicht groß genug, um alle Indikatorensatzbezeichner für die Indikatorensätze im angegebenen System zu speichern. Der Wert, auf den pcCounterSetIdsActual verweist, gibt die Größe des Puffers an, der zum Speichern aller Indikatorensatzbezeichner 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.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

PerfEnumerateCounterSetInstances