PdhEnumObjectsW-Funktion (pdh.h)
Gibt eine Liste der Objekte zurück, die auf dem angegebenen Computer oder in der angegebenen Protokolldatei verfügbar sind.
Verwenden Sie die PdhEnumObjectsH-Funktion , um Handles für Datenquellen zu verwenden.
Syntax
PDH_FUNCTION PdhEnumObjectsW(
[in] LPCWSTR szDataSource,
[in] LPCWSTR szMachineName,
[out] PZZWSTR mszObjectList,
[in, out] LPDWORD pcchBufferSize,
[in] DWORD dwDetailLevel,
[in] BOOL bRefresh
);
Parameter
[in] szDataSource
Nullbeendte Zeichenfolge, die den Namen der Protokolldatei angibt, die zum Aufzählen der Leistungsobjekte verwendet wird. Wenn NULL, verwendet die Funktion den in angegebenen Computer.
den szMachineName-Parameter zum Aufzählen der Namen.
[in] szMachineName
Null-beendete Zeichenfolge, die den Namen des Computers angibt, der zum Aufzählen der Leistungsobjekte verwendet wird.
Schließen Sie die führenden Schrägstriche in den Computernamen ein, z. B. \Computername.
Wenn der szDataSource-ParameterNULL ist, können Sie szMachineName auf NULL festlegen, um den lokalen Computer anzugeben.
[out] mszObjectList
Vom Aufrufer zugewiesener Puffer, der die Liste der Objektnamen empfängt. Jeder Objektname in dieser Liste wird durch ein NULL-Zeichen beendet. Die Liste wird mit zwei NULL-Abschlusszeichen beendet. Legen Sie auf NULL fest, wenn der parameter pcchBufferLength null ist.
[in, out] pcchBufferSize
Größe des mszObjectList-Puffers in TCHARs. Wenn null bei der Eingabe, gibt die Funktion PDH_MORE_DATA zurück und legt diesen Parameter auf die erforderliche Puffergröße fest. Wenn der Puffer größer als die erforderliche Größe ist, legt die Funktion diesen Parameter auf die tatsächliche Größe des verwendeten Puffers fest. Wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzuweisen.
Windows XP: Fügen Sie der erforderlichen Puffergröße eine hinzu.
[in] dwDetailLevel
Detailebene der zurückzugebenden Leistungselemente. Alle Elemente, die die angegebene Detailebene oder weniger aufweisen, werden zurückgegeben (die Ebenen werden in zunehmender Reihenfolge aufgeführt). Dieser Parameter kann einen der folgenden Werte annehmen.
[in] bRefresh
Gibt an, ob die zwischengespeicherte Objektliste automatisch aktualisiert werden soll. Geben Sie einen der folgenden Werte an.
Wenn Sie diese Funktion zweimal aufrufen, legen Sie einmal zum Abrufen der Größe der Liste und ein zweites Mal zum Abrufen der tatsächlichen Liste diesen Parameter für den ersten Aufruf auf TRUE und FALSE für den zweiten Aufruf fest. Wenn beide Aufrufe TRUE sind, gibt der zweite Aufruf möglicherweise auch PDH_MORE_DATA zurück, da sich die Objektdaten zwischen aufrufen geändert haben.
Wert | Bedeutung |
---|---|
|
Der Objektcache wird automatisch aktualisiert, bevor die Objekte zurückgegeben werden. |
|
Aktualisieren Sie den Cache nicht automatisch. |
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Die folgenden Werte sind möglich.
Rückgabecode | Beschreibung |
---|---|
|
Der mszObjectList-Puffer ist zu klein, um die Liste der Objekte zu speichern. Dieser Rückgabewert wird erwartet, wenn pcchBufferLength bei der Eingabe null ist. Wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzuweisen. |
|
Der angegebene Computer ist offline oder nicht verfügbar. |
|
Das angegebene Objekt konnte nicht gefunden werden. |
|
Ein Parameter ist nicht gültig. Bei einigen Releases kann dieser Fehler beispielsweise angezeigt werden, wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist. |
Hinweise
Sie sollten diese Funktion zweimal aufrufen, das erste Mal, um die erforderliche Puffergröße abzurufen (legen Sie mszObjectList auf NULL und pcchBufferLength auf 0 fest), und beim zweiten Mal, um die Daten abzurufen.
Hinweis
Der pdh.h-Header definiert PdhEnumObjects als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | pdh.h |
Bibliothek | Pdh.lib |
DLL | Pdh.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für