IPicture::get_hPal 方法 (ocidl.h)

检索图片对象当前使用的调色板的副本。

语法

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

parameters

[out] phPal

指向接收调色板句柄的变量的指针。 失败时,变量设置为 NULL

返回值

此方法支持E_FAIL和E_OUTOFMEMORY的标准返回值,以及以下值。

返回代码 说明
S_OK
已成功返回高度。
S_FALSE
此图片没有调色板。 phpal 指向的变量已设置为 NULL
E_POINTER
phPal 的值无效。 例如,它可能为 NULL

注解

给调用方的说明

如果图片对象拥有图片的所有权,它也拥有调色板的所有权,并且会在对象本身被销毁时销毁它。 否则,调用方拥有调色板。 OleCreatePictureIndirectfOwn 参数确定所有权。 OleLoadPicturefOwn 设置为 TRUE 以指示图片对象拥有调色板。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

请参阅

IPicture