创建标准图标提取程序,其默认值可以通过 IDefaultExtractIconInit 接口进一步配置。
Syntax
HRESULT SHCreateDefaultExtractIcon(
REFIID riid,
[out] void **ppv
);
参数
riid
类型: REFIID
对接口 ID 的引用。
[out] ppv
类型: void**
IDefaultExtractIconInit 接口指针的地址。
返回值
类型:HRESULT
如果此函数成功,它将返回 S_OK。 否则,它将返回 HRESULT 错误代码。
注解
此函数的预期用途如下所示:
IExtractIcon *pxi;
IDefaultExtractIconInit *pdxi;
HRESULT hr = SHCreateDefaultExtractIcon(IID_PPV_ARGS(&pdxi);
if (SUCCEEDED(hr)) &&
SUCCEEDED(hr = pdxi->SetFlags(GIL_PERCLASS)) &&
SUCCEEDED(hr = pdxi->SetKey(hkey)) && // optional
SUCCEEDED(hr = pdxi->SetNormalIcon(L"this.dll", 1)) &&
SUCCEEDED(hr = pdxi->SetOpenIcon(NULL, SIID_FOLDEROPEN)) && // optional
SUCCEEDED(hr = pdxi->SetDefaultIcon(NULL, SIID_FOLDER)) && // optional
SUCCEEDED(hr = pdxi->SetShortcutIcon(L"this.dll", 2))) // optional
{
hr = pdxi->QueryInterface(IID_PPV_ARGS(&pxi))
}
if (pdxi)
{
pdxi->Release();
}
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | shobjidl_core.h (包括 Shobjidl.h) |
| Library | OneCore.Lib |
| DLL | Shell32.dll |
| API 集 | ext-ms-win-shell-shell32-l1-2-1(在 Windows 10 版本 10.0.10240 中引入) |