DPA_LoadStream 函数 (dpa_dsa.h)

[DPA_LoadStream 在 Windows Vista 中可用。 在后续版本中,它可能已更改或不可用。 ]

通过调用指定的回调函数读取每个元素,从流加载动态指针数组 (DPA) 。

语法

HRESULT DPA_LoadStream(
  [out] HDPA         *phdpa,
  [in]  PFNDPASTREAM pfn,
  [in]  IStream      *pstream,
  [in]  void         *pvInstData
);

参数

[out] phdpa

类型: HDPA*

DPA 的句柄。

[in] pfn

类型: PFNDPASTREAM

回调函数。 有关回调函数原型,请参阅 PFNDPASTREAM

[in] pstream

类型: IStream*

IStream 对象。

[in] pvInstData

类型: void*

指向回调数据的指针。 pvInstData 作为参数传递给 pfn

返回值

类型: HRESULT

返回以下值之一。

返回代码 说明
S_OK
指示回调函数成功且元素已加载。
S_FALSE
指示回调函数在加载元素时失败;但是,该过程应继续。
E_INVALIDARG
指示一个或多个参数无效。
E_FAIL
指示无法读取流对象。
E_OUTOFMEMORY
缓冲区长度无效或内存不足,无法完成操作。

备注

必须直接从 ComCtl32.dll 调用此函数。 它是序号 9。

回调负责将 pvInstData 数据写入流。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 dpa_dsa.h
DLL ComCtl32.dll