функция обратного вызова PFSCE_SET_INFO (scesvc.h)

Статья
03/01/2024

Функция обратного вызова PFSCE_SET_INFO задает или перезаписывает сведения о конфигурации и анализе службы.

Синтаксис

PFSCE_SET_INFO PfsceSetInfo;

SCESTATUS PfsceSetInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [in]           PVOID pvInfo
)
{...}

Параметры

[in] sceHandle

Тип: SCE_HANDLE

Указывает непрозрачный дескриптор SCE, передаваемый вложению набором средств настройки безопасности во время вызова ISceSvcAttachmentData::Initialize. Этот дескриптор используется для задания или перезаписи сведений.

[in] sceType

Тип: SCESVC_INFO_TYPE

Указывает тип задаемой информации. Укажите один из следующих флагов.

Значение	Значение
SCE_SERVICE_CONFIGURATION_INFO	Указывает, что заданы сведения о конфигурации.
SCE_SERVICE_ANALYSIS_INFO	Указывает, что данные анализа заданы.

[in, optional] lpPrefix

Тип: LPTSTR

Указывает, какие сведения следует задать или перезаписать. В этой строке можно указать определенный ключ (см. раздел bExact) или префикс для набора ключей. При указании строки задаются только сведения для тех ключей (и их соответствующих значений), которые соответствуют строке. Если задано значение NULL, задается вся информация для службы.

[in] bExact

Тип: BOOL

Указывает, следует ли рассматривать строку, предоставленную lpPrefix , как определенный ключ или префикс для набора ключей. Этот параметр игнорируется, если lpPrefix имеет значение NULL.

Укажите одно из следующих значений.

Значение	Значение
TRUE	Строка, указанная в lpPrefix , представляет определенный ключ. Задан только этот ключ.
FALSE	Строка, заданная lpPrefix , представляет префикс для набора ключей. Заданы все ключи (и их значения), имеющие одинаковый префикс.

[in] pvInfo

Тип: PVOID

Возвращает указатель на одну из следующих структур. Набор средств настройки безопасности (а не вложение) выделяет буфер для информации; Поэтому этот указатель должен указывать на NULL.

Значение	Значение
SCESVC_CONFIGURATION_INFO	Если для параметра sceType задано значение SCE_SERVICE_CONFIGURATION_INFO.
SCESVC_ANALYSIS_INFO	Если sceType имеет значение SCE_SERVICE_ANALYSIS_INFO.

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

Тип: SCESTATUS

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

Код возврата	Описание
SCESTATUS_ACCESS_DENIED	Вызывающий объект не имеет достаточных привилегий для выполнения этого действия.
SCESTATUS_BAD_FORMAT	Формат плохой.
SCESTATUS_PREFIX_OVERFLOW	Существует больше данных, чем буфер может содержать.
SCESTATUS_INVALID_PARAMETER	Один из параметров, переданных в функцию, недопустим.
SCESTATUS_NOT_ENOUGH_RESOURCE	Недостаточно памяти.
SCESTATUS_OTHER_ERROR	Возникла неопределенная ошибка.
SCESTATUS_RECORD_NOT_FOUND	Указанная запись не найдена в базе данных безопасности.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	scesvc.h

См. также раздел

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

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