IImageList2::ForceImagePresent method (commoncontrols.h)

Forces an image present, as specified.

Syntax

HRESULT ForceImagePresent(
  [in] int   iImage,
  [in] DWORD dwFlags
);

Parameters

[in] iImage

Type: int

An index of image to force present.

[in] dwFlags

Type: DWORD

Force image flags. One of the following is valid.

Value	Meaning
ILFIP_ALWAYS 0x00000000	Always get the image (can be slow).
ILFIP_FROMSTANDBY 0x00000001	Only get if on standby.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	commoncontrols.h
DLL	Comctl32.dll (version 6.0 or later)