IWiaUIExtension2::GetDeviceIcon 方法
获取自定义设备图标。
语法
HRESULT GetDeviceIcon(
[in] BSTR bstrDeviceId,
[out] HICON *phIcon,
[in] ULONG nSize
);
参数
-
bstrDeviceId [in]
-
类型: BSTR
指定要为其获取图标的 WIA 设备的设备 ID。
-
phIcon [out]
-
类型: HICON*
指向将接收设备图标句柄的内存位置。
-
nSize [in]
-
类型: ULONG
指定所需的图标大小(以像素为单位)。 假定该图标为正方形,nSize 指定所请求图标的宽度和高度。
返回值
类型: HRESULT
如果该方法成功,则它会返回 S_OK。 如果方法失败,则返回相应的错误代码。 下表显示了一些可能的返回状态代码。
错误代码 | 说明 |
---|---|
E_INVALIDARG | 参数 bstrDeviceId 或 phIcon 为 NULL,或者 bstrDeviceId 不指向有效的 WIA 设备 ID 字符串 |
E_FAIL | 没有可用的图标资源。 |
E_NOTIMPL | 请求的大小图标不可用。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|