SHHandleUpdateImage 関数 (shlobj_core.h)
[SHHandleUpdateImage は、[要件] セクションで指定されたオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]
SHCNE_UPDATEIMAGE シェル変更通知を処理します。
構文
int SHHandleUpdateImage(
[in] PCIDLIST_ABSOLUTE pidlExtra
);
パラメーター
[in] pidlExtra
種類: PCIDLIST_ABSOLUTE
IShellChangeNotify::OnChange の pidl2 パラメーターで指定された、変更されたシステム イメージ リスト内のインデックス。
戻り値
型: int
失敗した場合は -1 を返し、成功した場合は変更されたイメージ リスト エントリのインデックスを返します。
注釈
変更通知コールバックによって受信された pidl2 パラメーターが NULL 以外の場合にのみ、SHHandleUpdateImage を使用します。
例
次の例では、IShellChangeNotify::OnChange の実装での SHHandleUpdateImage の使用を示します。
STDMETHODIMP CMyShellChangeNotify::OnChange(LONG lEvent,
LPCITEMIDLIST pidl1,
LPCITEMIDLIST pidl2)
{
HRESULT hr = E_FAIL;
int iImage;
switch(lEvent)
{
// An image in the system image list has changed.
case SHCNE_UPDATEIMAGE:
{
hr = S_OK;
if (pidl2)
iImage = SHHandleUpdateImage(pidl2);
else
iImage = *(int UNALIGNED *)((BYTE *)pidl1 + 2);
if (iImage != -1)
{
// Process iImage as desired.
}
break;
}
// Other cases
}
return hr;
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj_core.h (Shlobj.h を含む) |
| Library | Shell32.lib |
| [DLL] | Shell32.dll (バージョン 5.0 以降) |