SHOpenPropSheetA 函数 (shlobj.h)
[SHOpenPropSheet 可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]
从包含单个工作表的 CLSID的注册表项列表创建属性表,然后打开属性表。
语法
BOOL SHOpenPropSheetA(
[in, optional] LPCSTR pszCaption,
[in, optional] HKEY [] ahkeys,
UINT ckeys,
[in, optional] const CLSID *pclsidDefault,
[in] IDataObject *pdtobj,
[in, optional] IShellBrowser *psb,
[in, optional] LPCSTR pStartPage
);
参数
[in, optional] pszCaption
类型: LPCTSTR
指向包含属性表描述文字的字符串的指针。 如果不需要描述文字,此值可以为 NULL。
[in, optional] ahkeys
类型: HKEY[]
一个注册表项数组,表示单个属性表的 CLSID。
ckeys
类型: UINT
UINT 值,该值指定 由 ahkeys 指定的数组中的属性表数。
[in, optional] pclsidDefault
类型: const CLSID*
指向默认 CLSID 的指针。 此值可以为 NULL。
[in] pdtobj
类型: IDataObject*
指向 IDataObject 的指针,该 OLE 对象可用于对属性表执行操作 () 。
[in, optional] psb
类型: IShellBrowser*
未使用。
[in, optional] pStartPage
类型: LPCTSTR
指向指定起始页的字符串的指针。 此值可以为 NULL。
返回值
类型: BOOL
如果成功创建属性表,则返回 TRUE ;否则为 FALSE。
注解
注意
shlobj.h 标头将 SHOpenPropSheet 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | shlobj.h |
Library | Shell32.lib |
DLL | Shell32.dll (5.0 或更高版本) |