Freigeben über

PerfEnumerateCounterSet-Funktion (perflib.h)

  • Artikel

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.

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.
 

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