ISpecifyPropertyPages：：GetPages 方法 (ocidl.h)

  • 项目

检索可在此对象的属性表中显示的属性页的列表。

语法

HRESULT GetPages(
  [out] CAUUID *pPages
);

参数

[out] pPages

指向调用方分配的 CAUUID 结构的指针，函数在返回之前初始化并填充该结构。 结构中的 pElems 成员由具有 CoTaskMemAlloc 的函数分配，应由使用 CoTaskMemFree 的调用方释放。

返回值

此方法可以返回E_OUTOFMEMORY和E_UNEXPECTED的标准返回值，以及以下值。

返回代码 说明
S_OK
 该方法已成功完成。
E_POINTER
 pPages 中的地址无效。 例如，它可能为 NULL。

注解

CAUUID 结构由调用方分配，但不由调用方初始化。 GetPages 方法填充 结构中的 cElements 成员。 此方法还会使用 CoTaskMemAlloc 为 pElems 成员指向的数组分配内存。 然后，它填充新分配的数组。 此方法成功返回后，结构包含 UUID 的计数数组，每个 UUID 指定一个属性页 CLSID。

调用方备注

调用方必须释放 CAUUID 的 pElems 成员指向的内存，在不再需要时使用 CoTaskMemFree。

实施者说明

不允许E_NOTIMPL作为返回值，因为没有属性页的对象不应公开 ISpecifyPropertyPages 接口。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

ISpecifyPropertyPages