OleLoadPicturePath 函数 (olectl.h)

  • 项目

创建一个新的图片对象，并从流的内容初始化它。 这相当于调用 OleCreatePictureIndirect (NULL，...) 后跟 IPersistStream：：Load。

语法

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

parameters

[in] szURLorPath

要打开的文件的路径或 URL。

[in] punkCaller

指向 COM 聚合的 IUnknown 。

[in] dwReserved

保留。

[in] clrReserved

要保留为透明的颜色。

[in] riid

对接口标识符的引用，该标识符描述在 ppvRet 中返回的接口指针的类型。

[out] ppvRet

接收 riid 中请求的接口指针的指针变量的地址。 成功返回后，*ppvRet 包含名字对象所标识的对象存储上请求的接口指针。 如果 *ppvRet 为非 NULL，则此函数在接口上调用 IUnknown：：AddRef ;调用方负责调用 IUnknown：：Release。 如果发生错误，*ppvRet 设置为 NULL。

返回值

此函数支持标准返回值E_OUTOFMEMORY和E_UNEXPECTED，以及以下内容：

返回代码 说明
S_OK
 已成功创建对话框。
E_FAIL
 无法加载图片流。
E_POINTER
 ppvRet 中的地址为 NULL。
E_NOINTERFACE
 对象不支持 riid 中指定的接口。

注解

流必须采用 BMP (位图) 、JPEG、WMF (图元文件) 、ICO (图标) 或 GIF 格式。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 olectl.h
Library OleAut32.lib
DLL OleAut32.dll

请参阅

OleLoadPicture