IShellImageDataFactory::CreateImageFromFile 方法 (shimgdata.h)

基于给定文件创建 IShellImageData 接口的实例。

语法

HRESULT CreateImageFromFile(
  [in]  LPCWSTR         pszPath,
  [out] IShellImageData **ppshimg
);

参数

[in] pszPath

类型: LPCWSTR

包含图像的文件的路径。 如果此参数为 NULL,则会导致未经处理的异常。

[out] ppshimg

类型: IShellImageData**

指向 IShellImageData 实例的指针的地址。

返回值

类型: HRESULT

如果成功,则返回S_OK,否则返回错误值,包括以下内容:

返回代码 说明
E_OUTOFMEMORY
无法实例化内部对象。
E_NOINTERFACE
内部对象不支持 IShellImageDataIPersistFile 接口。
E_POINTER
ppshimg 参数为 NULL

注解

如果 pszPathNULL,则会发生访问冲突。

要求

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