0 out of 1 rated this helpful - Rate this topic

GetPaletteEntries function

Applies to: desktop apps only

The GetPaletteEntries function retrieves a specified range of palette entries from the given logical palette.

Syntax

Copy

UINT GetPaletteEntries(
  __in   HPALETTE hpal,
  __in   UINT iStartIndex,
  __in   UINT nEntries,
  __out  LPPALETTEENTRY lppe
);

Parameters

hpal [in]: A handle to the logical palette.
iStartIndex [in]: The first entry in the logical palette to be retrieved.
nEntries [in]: The number of entries in the logical palette to be retrieved.
lppe [out]: A pointer to an array of PALETTEENTRY structures to receive the palette entries. The array must contain at least as many structures as specified by the nEntries parameter.

Return value

If the function succeeds and the handle to the logical palette is a valid pointer (not NULL), the return value is the number of entries retrieved from the logical palette. If the function succeeds and handle to the logical palette is NULL, the return value is the number of entries in the given palette.

If the function fails, the return value is zero.

Remarks

An application can determine whether a device supports palette operations by calling the GetDeviceCaps function and specifying the RASTERCAPS constant.

If the nEntries parameter specifies more entries than exist in the palette, the remaining members of the PALETTEENTRY structure are not altered.

Requirements