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 以降)

こちらもご覧ください

IShellChangeNotify

SHChangeNotify