PFSCE_QUERY_INFO回调函数 (scesvc.h)

  • 项目

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

另请参阅

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO