Функция InstallPerfDllA (loadperf.h)

Статья
11/20/2024

Устанавливает строки счетчика производительности, как определено в входном .ini файле, в системный реестр.

Примечание Майкрософт рекомендует разработчикам использовать LoadPerfCounterTextStrings вместо InstallPerfDll. LoadPerfCounterTextStrings вызывает InstallPerfDll внутренне.

Синтаксис

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

Параметры

[in] szComputerName

Имя системы. Это должно быть значение NULL, так как эта функция не может использоваться для удаленной установки.

[in] lpIniFile

Имя файла инициализации, содержащего определения, добавляемые в реестр.

[in] dwFlags

Этот параметр может быть LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8).

Возвращаемое значение

Если функция выполнена успешно, она возвращает TRUE и публикует дополнительные сведения в журнале событий приложения. В противном случае возвращается код ошибки, представляющий условие, вызвавшее сбой.

Замечания

Эта функция не имеет связанной библиотеки импорта; Его необходимо вызвать с помощью LoadLibrary и функций GetProcAddress.

Заметка

Заголовок loadperf.h определяет InstallPerfDll как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	loadperf.h
DLL	Loadperf.dll

См. также

LoadPerfCounterTextStrings

Поделиться через