IImageList2::D iscardImages メソッド (commoncontrols.h)

指定されたとおりに、リストからイメージを破棄します。

構文

HRESULT DiscardImages(
  [in] int   iFirstImage,
  [in] int   iLastImage,
  [in] DWORD dwFlags
);

[in] iFirstImage

型: int

破棄する最初のイメージのインデックス。

[in] iLastImage

型: int

破棄する最後のイメージのインデックス。

[in] dwFlags

種類: DWORD

イメージフラグを破棄します。 ILDI_STANDBY と ILDI_PURGE は相互に排他的です。 ILDI_RESETACCESS は、いずれかと組み合わせることができます。次の 1 つ以上が有効です。

値	意味
ILDI_PURGE 0x00000001	破棄と消去。
ILDI_STANDBY 0x00000002	スタンバイリストに破棄します。
ILDI_RESETACCESS 0x00000004	"アクセスされました" フラグをリセットします。
ILDI_QUERYACCESS 0x00000008	アクセスフラグが設定されているかどうかを確認します (ただし、リセットは行いません)。

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。