Edit

Share via

InstallPerfDllA function (loadperf.h)

  • Article

Installs performance counter strings, as defined in an input .ini file, into the system registry.

Note  Microsoft recommends that developers use LoadPerfCounterTextStrings instead of InstallPerfDll. LoadPerfCounterTextStrings calls InstallPerfDll internally.
 

Syntax

LOADPERF_FUNCTION InstallPerfDllA(
  [in] LPCSTR    szComputerName,
  [in] LPCSTR    lpIniFile,
  [in] ULONG_PTR dwFlags
);

Parameters

[in] szComputerName

The name of the system. This should be NULL because this function cannot be used to install remotely.

[in] lpIniFile

The name of the initialization file that contains definitions to add to the registry.

[in] dwFlags

This parameter can be LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8).

Return value

If the function is successful, it returns TRUE and posts additional information in an application event log. Otherwise, it returns an error code that represents the condition that caused the failure.

Remarks

This function has no associated import library; you must call it using the LoadLibrary and GetProcAddress functions.

Note

The loadperf.h header defines InstallPerfDll as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Target Platform Windows
Header loadperf.h
DLL Loadperf.dll

See also

LoadPerfCounterTextStrings