Share via

LoadPerfCounterTextStringsW-Funktion (loadperf.h)

  • Artikel

Lädt die in der angegebenen Initialisierungsdatei definierten Leistungsobjekte und Leistungsindikatoren auf den Computer.

Syntax

LOADPERF_FUNCTION LoadPerfCounterTextStringsW(
  [in] LPWSTR lpCommandLine,
  [in] BOOL   bQuietModeArg
);

Parameter

[in] lpCommandLine

Null-endende Zeichenfolge, die aus einem oder mehreren beliebigen Buchstaben, einem Leerzeichen und dann dem Namen der Initialisierungsdatei (.ini) besteht. Der Name kann den Pfad zur Initialisierungsdatei enthalten.

Die Funktion verwendet nur die Initialisierungsdatei. Das erste Argument wird verworfen. Wenn Sie beispielsweise eine Initialisierungsdatei mit dem Namen "myfile.ini" laden möchten, könnte die commandLine-Zeichenfolge "xx myfile.ini" lauten. Die Buchstaben vor dem Leerzeichen (hier "xx") werden verworfen, und der zweite Teil nach dem Leerzeichen wird als Initialisierungsdateispezifikation interpretiert.

[in] bQuietModeArg

Legen Sie diese Einstellung auf TRUE fest, um zu verhindern, dass die Funktion die Ausgabe des Lodctr-Tools anzeigt. andernfalls FALSE. Dieser Parameter hat nur Bedeutung, wenn die Anwendung über eine Eingabeaufforderung ausgeführt wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Systemfehlercodes.

Hinweise

Diese Funktion stellt eine API für die Funktionalität bereit, die vom Lodctr-Tool bereitgestellt wird. Informationen zu Lodctr finden Sie unter Hinzufügen von Leistungsindikatornamen und -beschreibungen zur Registrierung.

Hinweis

Der loadperf.h-Header definiert LoadPerfCounterTextStrings 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

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile loadperf.h
Bibliothek Loadperf.lib
DLL Loadperf.dll

Weitere Informationen

UnloadPerfCounterTextStrings