PSRegisterPropertySchema 函数 (propsys.h)

通知架构子系统添加属性说明架构文件。

语法

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

参数

[in] pszPath

类型: PCWSTR

指向完整文件路径(作为 Unicode 字符串)的指针,指向本地计算机上的 属性说明架构 (.propdesc) 文件。 这可以是完全指定的完整路径,也可以是包含环境变量的完整路径,例如 %PROGRAMFILES%

返回值

类型: HRESULT

返回以下值之一。

返回代码 说明
S_OK
架构中的所有属性说明都已注册。
E_ACCESSDENIED
调用上下文没有适当的权限。
INPLACE_S_TRUNCATED
架构中的一个或多个属性说明无法注册。 特定的失败记录在应用程序事件日志中。

注解

此函数是架构子系统实现 IPropertySystem::RegisterPropertySchema 的包装器 API。 仅当文件首次安装在计算机上时,才调用此函数。 通常,安装应用程序在安装 .propdesc 文件后调用此函数,该文件应存储在 Program Files 下的应用程序的安装目录中。 可以对 IPropertySystem::RegisterPropertySchema 进行多次调用,以便注册多个架构文件。

注册属性架构文件时,请记住,它们可由以不同用户身份运行的进程读取。 因此,请务必将架构文件放置在向计算机上的所有用户授予读取访问权限的位置。 同样,使用此函数的 pszPath 参数中的文件的绝对路径。

注意 由于架构特定于计算机,无法为每个用户注册,因此 Windows Vista 不支持在用户配置文件下注册文件路径。
 
如果遇到阻止加载属性说明的完全或部分故障,则会在应用程序事件日志中记录原因。 如果调用上下文没有适当的权限(包括对HKEY_LOCAL_MACHINE的写入访问权限),此函数将失败并E_ACCESSDENIED。 调用应用程序负责通过用户帐户控制 (UAC) 机制获取特权。

要求

要求
最低受支持的客户端 Windows XP SP2、Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 propsys.h
Library Propsys.lib
DLL Propsys.dll (5.0 或更高版本)
可再发行组件 Windows 桌面搜索 (WDS) 3.0