DestroyIcon 関数 (winuser.h)

  • [アーティクル]

アイコンを破棄し、アイコンが占有していたメモリを解放します。

構文

BOOL DestroyIcon(
  [in] HICON hIcon
);

パラメーター

[in] hIcon

種類: HICON

破棄するアイコンのハンドル。 アイコンを使用することはできません。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

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

解説

CreateIconFromResourceEx (LR_SHARED フラグなしで呼び出された場合)、CreateIconIndirect、および CopyIcon の各関数で作成されたアイコンとカーソルに対してのみ 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-1-0 (Windows 8 で導入)

関連項目

概念

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

アイコン

参照