IPicture::set_hPal method (ocidl.h)

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

See also

IPicture