SHLoadNonloadedIconOverlayIdentifiers 関数 (shellapi.h)

オーバーレイ情報を必要とする次の操作中に、作成に失敗したか、起動時に作成に存在しなかったアイコン オーバーレイ識別子を読み込む必要があることをシェルに通知します。 既に読み込まれている識別子は影響を受けません。

構文

SHSTDAPI SHLoadNonloadedIconOverlayIdentifiers();

戻り値

種類: HRESULT

常に S_OK を返します。

解説

SHLoadNonloadedIconOverlayIdentifiers を呼び出しても、シェル拡張機能がすぐに読み込まれることはなく、アイコン オーバーレイ ハンドラーが読み込まれることはありません。 SHLoadNonloadedIconOverlayIdentifiers を呼び出すと、アイコン オーバーレイ情報を要求する次のコードによって、レジストリ内のアイコン オーバーレイと既に読み込まれているアイコン オーバーレイの比較がトリガーされる状況になります。 アイコン オーバーレイが新しく登録され、システムが 15 のアイコン オーバーレイの上限にまだ達していない場合は、新しいオーバーレイが読み込まれます。 SHLoadNonloadedIconOverlayIdentifiers だけでは、新しいアイコン オーバーレイは読み込まれません。また、Windows エクスプローラー ビューの更新など、オーバーレイを使用するアクションをトリガーする必要もあります。

詳細については、「 アイコン オーバーレイ ハンドラーを実装する方法」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shellapi.h
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)