InstallPerfDllW-Funktion (loadperf.h)

Artikel
03/04/2024

Installiert Leistungsindikatorzeichenfolgen, wie in einer Eingabedatei .ini definiert, in der Systemregistrierung.

Hinweis Microsoft empfiehlt Entwicklern die Verwendung von LoadPerfCounterTextStrings anstelle von InstallPerfDll. LoadPerfCounterTextStrings ruft InstallPerfDll intern auf.

Syntax

LOADPERF_FUNCTION InstallPerfDllW(
  [in] LPCWSTR   szComputerName,
  [in] LPCWSTR   lpIniFile,
  [in] ULONG_PTR dwFlags
);

Parameter

[in] szComputerName

Der Name des Systems. Dies sollte NULL sein, da diese Funktion nicht für die Remoteinstallation verwendet werden kann.

[in] lpIniFile

Der Name der Initialisierungsdatei, die Definitionen enthält, die der Registrierung hinzugefügt werden sollen.

[in] dwFlags

Dieser Parameter kann LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8) sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück und stellt zusätzliche Informationen in ein Anwendungsereignisprotokoll. Andernfalls wird ein Fehlercode zurückgegeben, der die Bedingung darstellt, die den Fehler verursacht hat.

Hinweise

Dieser Funktion ist keine Importbibliothek zugeordnet. Sie müssen sie mit den Funktionen LoadLibrary und GetProcAddress aufrufen.

Hinweis

Der loadperf.h-Header definiert InstallPerfDll 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
Zielplattform	Windows
Kopfzeile	loadperf.h
DLL	Loadperf.dll

Weitere Informationen

LoadPerfCounterTextStrings

Freigeben über