IImageList2::ForceImagePresent method (commoncontrols.h)

  • Article

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)