This function is typically used after GpiSelectPalette or in response to a WM_REALIZEPALETTE message. It causes the system to ensure that the palette is appropriately realized for all drawing operations.

When the window has the input focus, the palette will be realized absolutely. Otherwise, the realization is on a best-can-do basis. If the palette is larger than the currently associated device can support, as many entries as possible are realized, starting from the lowest index.

If the presentation space is currently associated with a device context of type OD_MEMORY (see DevOpenDC), then this function performs no function other than returning without error.

This function must not be called while processing a WM_SETFOCUS message, because a window's activation state is not known until processing of this message is complete.

Note that the palette cannot be physically changed on all devices. The effect of this call is therefore device dependent.