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

Статья
08/25/2023

Функция обратного вызова PFSCE_QUERY_INFO запрашивает сведения, относящиеся к службе, из файла конфигурации безопасности или базы данных анализа.

Синтаксис

PFSCE_QUERY_INFO PfsceQueryInfo;

SCESTATUS PfsceQueryInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [out]          PVOID *ppvInfo,
  [out]          PSCE_ENUMERATION_CONTEXT psceEnumHandle
)
{...}

Параметры

[in] sceHandle

Тип: SCE_HANDLE

Указывает непрозрачный дескриптор, передаваемый в вложение средством настройки безопасности, заданным во время вызова 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 , представляет префикс. Возвращаются все ключи (и их значения), имеющие один и тот же префикс.

[out] ppvInfo

Тип: PVOID*

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

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

[out] psceEnumHandle

Тип: PSCE_ENUMERATION_CONTEXT

Возвращает дескриптор, который можно использовать в последовательных вызовах этой функции. Из-за большого количества ключей, которые могут присутствовать, не все ключи возвращаются в одном вызове. Максимальное количество ключей, которые могут быть возвращены в одном вызове, составляет 256.

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

Тип: SCESTATUS

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

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

Набор средств настройки безопасности выделяет буферы при вызове PFSCE_QUERY_INFO . Чтобы освободить эти буферы, вызовите PFSCE_FREE_INFO после того, как возвращаемые сведения больше не нужны.

Примеры

Пример	См.
Получение сведений о конфигурации	Реализация SceSvcAttachmentConfig
Получение аналитических сведений	Реализация SceSvcAttachmentAnalyze
Получение сведений о конфигурации и анализе	Реализация SceSvcAttachmentUpdate

Требования

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

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

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

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