CopyIcon 関数 (winuser.h)

指定したアイコンを別のモジュールから現在のモジュールにコピーします。

構文

HICON CopyIcon(
  [in] HICON hIcon
);

パラメーター

[in] hIcon

種類: HICON

コピーするアイコンへのハンドル。

戻り値

種類: HICON

関数が成功した場合、戻り値は重複するアイコンへのハンドルです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

CopyIcon 関数を使用すると、アプリケーションまたは DLL は、別のモジュールが所有するアイコンに対する独自のハンドルを取得できます。 もう一方のモジュールが解放された場合でも、アプリケーション アイコンはアイコンを使用できます。

閉じる前に、アプリケーションで DestroyIcon 関数を呼び出して、アイコンに関連付けられているシステム リソースを解放する必要があります。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-gui-l1-3-0 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

概念

CopyCursor

DestroyIcon

DrawIcon

DrawIconEx

アイコン

参照