DestroyIcon 関数 (winuser.h)
アイコンを破棄し、アイコンが占有していたメモリを解放します。
構文
BOOL DestroyIcon(
[in] HICON hIcon
);
パラメーター
[in] hIcon
種類: HICON
破棄するアイコンのハンドル。 アイコンを使用することはできません。
戻り値
種類: BOOL
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
CreateIconFromResourceEx (LR_SHARED フラグなしで呼び出された場合)、CreateIconIndirect、および CopyIcon の各関数で作成されたアイコンとカーソルに対してのみ DestroyIcon を呼び出す必要があります。 この関数を使用して共有アイコンを破棄しないでください。 共有アイコンは、読み込まれたモジュールがメモリ内に残っている限り有効です。 次の関数は、共有アイコンを取得します。
- LoadIcon
- LoadImage ( LR_SHARED フラグを使用する場合)
- CopyImage ( LR_COPYRETURNORG フラグを使用し、 hImage パラメーターが共有アイコンの場合)
- CreateIconFromResource
- CreateIconFromResourceEx ( LR_SHARED フラグを使用する場合)
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | 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 で導入) |
関連項目
概念
参照