PdhLookupPerfIndexByNameA-Funktion (pdh.h)

Gibt den Zählerindex zurück, der dem angegebenen Zählernamen entspricht.

Syntax

PDH_FUNCTION PdhLookupPerfIndexByNameA(
  [in]  LPCSTR  szMachineName,
  [in]  LPCSTR  szNameBuffer,
  [out] LPDWORD pdwIndex
);

Parameter

[in] szMachineName

Null--terminated-Zeichenfolge, die den Namen des Computers angibt, auf dem sich der angegebene Zähler befindet. Der Computername kann durch den DNS-Namen oder die IP-Adresse angegeben werden. Wenn NULL-, verwendet die Funktion den lokalen Computer.

[in] szNameBuffer

Null--terminated-Zeichenfolge, die den Zählernamen enthält.

[out] pdwIndex

Index des Zählers.

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. Es folgt ein möglicher Wert.

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Ein Parameter ist ungültig oder falsch formatiert.

Bemerkungen

Anmerkung

Der pdh.h-Header definiert PdhLookupPerfIndexByName 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

Siehe auch

PdhLookupPerfNameByIndex