LoadPerfCounterTextStringsA-Funktion (loadperf.h)
Lädt auf den Computer die Leistungsobjekte und Leistungsindikatoren, die in der angegebenen Initialisierungsdatei definiert sind.
Syntax
LOADPERF_FUNCTION LoadPerfCounterTextStringsA(
[in] LPSTR lpCommandLine,
[in] BOOL bQuietModeArg
);
Parameter
[in] lpCommandLine
Null-beendete 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. Um beispielsweise eine Initialisierungsdatei mit dem Namen "myfile.ini" zu laden, 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
Auf TRUE- festgelegt, um zu verhindern, dass die Funktion die Ausgabe aus dem Lodctr Tool anzeigt; andernfalls FALSE. Dieser Parameter hat nur dann 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.
Bemerkungen
Diese Funktion stellt eine API für die Funktionalität bereit, die vom Lodctr Tool bereitgestellt wird. Informationen zu Lodctrfinden Sie unter Hinzufügen von Zählernamen und Beschreibungen zur Registrierung.
Anmerkung
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | loadperf.h |
| Library | Loadperf.lib |
| DLL- | Loadperf.dll |