SHOpenPropSheetW 函数 (shlobj.h)

[SHOpenPropSheet 可用于“要求”部分中指定的操作系统。 在后续版本中可能会更改或不可用。

从包含单个工作表 CLSID的注册表项列表中创建属性表,然后打开属性表。

语法

BOOL SHOpenPropSheetW(
  [in, optional] LPCWSTR       pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCWSTR       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的指针,该对象可用于对属性表执行操作。

[in, optional] psb

类型:IShellBrowser*

未使用。

[in, optional] pStartPage

类型:LPCTSTR

指向指定起始页的字符串的指针。 此值可以 NULL

返回值

类型:BOOL

如果已成功创建属性表,则返回 TRUE;否则,FALSE

言论

注意

shlobj.h 标头将 SHOpenPropSheet 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 shlobj.h
Shell32.lib
DLL Shell32.dll (版本 5.0 或更高版本)