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

Статья
11/20/2024

Загружает на компьютер объекты производительности и счетчики, определенные в указанном файле инициализации.

Синтаксис

LOADPERF_FUNCTION LoadPerfCounterTextStringsA(
  [in] LPSTR lpCommandLine,
  [in] BOOL  bQuietModeArg
);

Параметры

[in] lpCommandLine

Строка, завершающаяся значением NULL, состоящая из одного или нескольких произвольных букв, пробела, а затем имя файла инициализации (.ini) . Имя может содержать путь к файлу инициализации.

Функция использует только файл инициализации; первый аргумент удаляется. Например, чтобы загрузить файл инициализации с именем "myfile.ini", строка командной строки может быть "xx myfile.ini". Буквы перед пробелом (здесь "xx") удаляются, а вторая часть после пробела интерпретируется как спецификация файла инициализации.

[in] bQuietModeArg

Установите значение TRUE, чтобы функция не отображала выходные данные из средства Lodctr; в противном случае FALSE. Этот параметр имеет значение, только если приложение выполняется из командной строки.

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

Если функция выполнена успешно, она возвращает ERROR_SUCCESS.

Если функция завершается ошибкой, возвращаемое значение является одним из системных кодов ошибок.

Замечания

Эта функция предоставляет API для функциональных возможностей, предоставляемых средством Lodctr. Сведения о Lodctrсм. в добавлении имен счетчиков и описаний в реестр.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	loadperf.h
библиотеки	Loadperf.lib
DLL	Loadperf.dll

См. также

LoadPerfCounterTextStrings

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