Freigeben über


PdhVbOpenQuery-Funktion

Die PdhVbOpenQuery-Funktion erstellt und initialisiert eine eindeutige Abfragestruktur, die zum Verwalten der Sammlung von Leistungsdaten verwendet wird.

Wichtig

Die in diesem Thema beschriebene Funktion kann in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfiehlt Microsoft, die unter Leistungsindikatorenfunktionen beschriebenen Funktionen zu verwenden.

Funktion pdhVbOpenQuery( _ ByVal QueryHandle As Long _ ) As Long

Parameter

QueryHandle

Variable, die gelöscht wird (gleich 0), bevor die Funktion aufgerufen wird, und enthält, wenn die Funktion erfolgreich ist, die eindeutige ID der Abfrage, die erstellt und geöffnet wird. Dieses Handle wird in den nachfolgenden Aufrufen anderer PDH-Funktionen verwendet, um die Abfrage zu identifizieren.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie eine ganzzahlige Long-Zahl zurück, die ERROR_SUCCESS und ein neues Handle in der QueryHandle-Variable entspricht.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode Beschreibung
PDH_INVALID_ARGUMENT
Das Argument ist ungültig oder falsch.
PDH_MEMORY_ALLOCATION_FAILURE
Ein temporärer Speicherpuffer konnte nicht zugewiesen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Bibliothek
Pdh.lib
DLL
Pdh.dll

Siehe auch

PdhCloseQuery