PdhGetDefaultPerfCounterHW-Funktion (pdh.h)
Ruft den Namen des Standardzählers für das angegebene Objekt ab. Dieser Name kann verwendet werden, um die anfängliche Zählerauswahl im Dialogfeld "Suchindikator" festzulegen.
Diese Funktion ist identisch mit PdhGetDefaultPerfCounter, mit der Ausnahme, dass sie die Verwendung von Handles für Datenquellen unterstützt.
Syntax
PDH_FUNCTION PdhGetDefaultPerfCounterHW(
[in] PDH_HLOG hDataSource,
[in] LPCWSTR szMachineName,
[in] LPCWSTR szObjectName,
[out] LPWSTR szDefaultCounterName,
[in, out] LPDWORD pcchBufferSize
);
Parameter
[in] hDataSource
Sollte NULL-sein.
Wenn Sie ein Protokolldateihandle angeben, ist szDefaultCounterName eine NULL- Zeichenfolge.
[in] szMachineName
Null--terminated-Zeichenfolge, die den Namen des Computers angibt, der zum Überprüfen des Objektnamens verwendet wird. Wenn NULL-, wird der lokale Computer verwendet, um den Namen zu überprüfen.
[in] szObjectName
null-terminated string, der den Namen des Objekts angibt, dessen Standardzählername Sie abrufen möchten.
[out] szDefaultCounterName
Vom Aufrufer zugewiesener Puffer, der den null--terminated-Standardzählernamen empfängt. Wird auf NULL- festgelegt, wenn pcchBufferSize null ist.
[in, out] pcchBufferSize
Größe des szDefaultCounterName Puffers in TCHARs. Wenn null bei eingaben, 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 für die Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie nicht auf die zurückgegebene Größe zurückgreifen, um den Puffer neu zuzuweisen.
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. Im Folgenden sind mögliche Werte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der szDefaultCounterName Puffer ist zu klein, um den Zählernamen zu enthalten. Dieser Rückgabewert wird erwartet, wenn pcchBufferSize für die Eingabe null ist. Wenn die angegebene Größe für die Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie nicht auf die zurückgegebene Größe zurückgreifen, um den Puffer neu zuzuweisen. |
|
Ein erforderlicher Parameter ist ungültig. Bei einigen Versionen können Sie diesen Fehler z. B. erhalten, wenn die angegebene Größe für die Eingabe größer als 0, aber kleiner als die erforderliche Größe ist. |
|
Speicher kann nicht zugeordnet werden, um die Funktion abzuschließen. |
|
Der angegebene Computer ist offline oder nicht verfügbar. |
|
Der Standardzählername kann nicht gelesen oder gefunden werden. |
|
Das angegebene Objekt konnte nicht gefunden werden. |
|
Das Objekt hat keinen Standardzähler angegeben. |
Bemerkungen
Sie sollten diese Funktion zweimal aufrufen, zum ersten Mal die erforderliche Puffergröße abrufen (szDefaultCounterName auf NULL- und pcchBufferSize auf 0 festgelegt) und das zweite Mal, um die Daten abzurufen.
Anmerkung
Der pdh.h-Header definiert PdhGetDefaultPerfCounterH 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | pdh.h |
| Library | Pdh.lib |
| DLL- | Pdh.dll |