PerfEnumerateCounterSetInstances-Funktion (perflib.h)
Ruft die Namen und Bezeichner der aktiven Instanzen eines Leistungsindikatorsatzes für die
angegebenes System.
Syntax
ULONG PerfEnumerateCounterSetInstances(
[in, optional] LPCWSTR szMachine,
[in] LPCGUID pCounterSetId,
[out, optional] PPERF_INSTANCE_HEADER pInstances,
DWORD cbInstances,
[out] LPDWORD pcbInstancesActual
);
Parameter
[in, optional] szMachine
Der Name des Computers, für den die Informationen über die aktiven Instanzen des Leistungsindikatorsatzes abgerufen werden sollen, die vom pCounterSet-Parameter angegeben werden. Bei NULL ruft die Funktion Informationen zu den aktiven Instanzen des angegebenen Leistungsindikatorsatzes für den lokalen Computer ab.
[in] pCounterSetId
Der Indikatorsatzbezeichner des Indikatorsatzes, für den Sie die Informationen zu den aktiven Instanzen abrufen möchten.
[out, optional] pInstances
Zeiger auf einen Puffer, der groß genug ist, um die vom cbInstances-Parameter festgelegte Datenmenge zu empfangen. Kann sein
NULL, wenn cbInstances 0 ist.
cbInstances
Die Größe des Puffers, den der pInstances-Parameter in Bytes angibt.
[out] pcbInstancesActual
Die Größe des Puffers, die tatsächlich erforderlich ist, um die Informationen zu den aktiven Instanzen abzurufen. Die Bedeutung hängt vom Wert der Funktion ab.
Gibt.
| Funktionsrückgabewert | Bedeutung von pcbInstancesActual |
|---|---|
| ERROR_SUCCESS | Die Anzahl von Byte von Informationen über die aktiven Instanzen des angegebenen Indikatorsatzes, den die Funktion in dem Puffer gespeichert hat, den pInstances angegeben hat. |
| ERROR_NOT_ENOUGH_MEMORY | The Größe des Puffers, der erforderlich ist, um die Informationen über die aktiven Instanzen des Leistungsindikators auf dem angegebenen Computer in Bytes zu speichern. 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 |
|---|---|
|
Die Funktion speicherte erfolgreich alle Informationen zu den aktiven Instanzen des Indikatorsatzes im Puffer, den pInstances angegeben hat. Der Wert, auf den pcbInstancesActual verweist, gibt die Menge der tatsächlich im Puffer gespeicherten Informationen in Bytes an. |
|
Der puffer, den pInstances angegeben hat, war nicht groß genug, um alle Informationen zu den aktiven Instanzen des Leistungsindikatorsatzes zu speichern. Der Wert, auf den pcbInstancesActual verweist, 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
Die Informationen zu den aktiven Instanzen des angegebenen Leistungsindikatorsatzes werden in den Puffer geschrieben, den pInstances als Sequenz von PERF_INSTANCE_HEADER Blöcken angibt. Die Größe in Bytes von
die Sequenz von Blöcken wird in pcbInstancesActual geschrieben. Jeder PERF_INSTANCE_HEADER-Block besteht aus
einer PERF_INSTANCE_HEADER-Struktur , unmittelbar gefolgt von einem NULL-beendeten UTF-16LE
instance Namen, gefolgt von Auffüllung, damit die Größe des
PERF_INSTANCE_HEADER Block ist ein Vielfaches von 8 Bytes.
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 |