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