IPicture::set_hPal method (ocidl.h)

Article
02/22/2024

Assigns a GDI palette to the picture contained in the picture object.

Syntax

HRESULT set_hPal(
  [in] OLE_HANDLE hPal
);

Parameters

[in] hPal

A handle to the GDI palette assigned to the picture.

Return value

This method supports the standard return values E_FAIL, E_INVALIDARG, E_OUTOFMEMORY, and S_OK.

Remarks

Notes to Implementers

Ownership of the palette passed to this method depends on how the picture object was created, as specified by the fOwn parameter to OleCreatePictureIndirect. OleLoadPicture forces fOwn to TRUE; if the object owns the picture, then it takes over ownership of this palette.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ocidl.h

Share via