InstallPerfDllA-Funktion (loadperf.h)

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

Hinweis Microsoft empfiehlt Entwicklern, LoadPerfCounterTextStrings anstelle von InstallPerfDll-zu verwenden. LoadPerfCounterTextStrings intern InstallPerfDll aufruft.

 

Syntax

LOADPERF_FUNCTION InstallPerfDllA(
  [in] LPCSTR    szComputerName,
  [in] LPCSTR    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, wird TRUE- zurückgegeben und zusätzliche Informationen in einem Anwendungsereignisprotokoll bereitgestellt. Andernfalls wird ein Fehlercode zurückgegeben, der die Bedingung darstellt, die den Fehler verursacht hat.

Bemerkungen

Diese Funktion weist keine zugeordnete Importbibliothek auf; Sie müssen sie mit den funktionen LoadLibrary und GetProcAddress aufrufen.

Anmerkung

Der header loadperf.h definiert InstallPerfDll als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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-	Fenster
Header-	loadperf.h
DLL-	Loadperf.dll

Siehe auch

LoadPerfCounterTextStrings