PdhLookupPerfIndexByNameW-Funktion (pdh.h)

  • Artikel

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

Syntax

PDH_FUNCTION PdhLookupPerfIndexByNameW(
  [in]  LPCWSTR szMachineName,
  [in]  LPCWSTR szNameBuffer,
  [out] LPDWORD pdwIndex
);

Parameter

[in] szMachineName

Null-terminierte Zeichenfolge, die den Namen des Computers angibt, auf dem sich der angegebene Indikator 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-beendete 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. Im Folgenden ist ein möglicher Wert aufgeführt.

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

Hinweise

Hinweis

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
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

PdhLookupPerfNameByIndex