基于给定文件创建 IShellImageData 接口的实例。
语法
HRESULT CreateImageFromFile(
[in] LPCWSTR pszPath,
[out] IShellImageData **ppshimg
);
参数
[in] pszPath
类型: LPCWSTR
包含图像的文件的路径。 如果此参数为 NULL,则会导致未经处理的异常。
[out] ppshimg
类型: IShellImageData**
指向 IShellImageData 实例的指针的地址。
返回值
类型: HRESULT
如果成功,则返回S_OK,否则返回错误值,包括以下内容:
| 返回代码 | 说明 |
|---|---|
|
无法实例化内部对象。 |
|
内部对象不支持 IShellImageData 或 IPersistFile 接口。 |
|
ppshimg 参数为 NULL。 |
注解
如果 pszPath 为 NULL,则会发生访问冲突。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shimgdata.h |
| DLL | Shell32.dll |