PFSCE_SET_INFO回调函数 (scesvc.h)

  • 项目

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

指定在调用 ISceSvcAttachmentData：：Initialize 期间由安全配置工具集传递给附件的不透明 SCE 句柄。 此句柄用于设置或覆盖信息。

[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
标头 scesvc.h

另请参阅

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO