Поделиться через

Метод IPicture::get_Handle (ocidl.h)

  • Статья

Извлекает дескриптор изображения, управляемого в этом объекте рисунка, в указанное расположение.

Синтаксис

HRESULT get_Handle(
  [out] OLE_HANDLE *pHandle
);

Параметры

[out] pHandle

Указатель на переменную, получающую дескриптор. Вызывающий объект отвечает за этот дескриптор после успешного возврата. При сбое переменной присваивается значение NULL .

Возвращаемое значение

Этот метод поддерживает стандартные возвращаемые значения E_FAIL и E_OUTOFMEMORY, а также следующие значения.

Код возврата Описание
S_OK
 Дескриптор был успешно возвращен.
E_POINTER
 Недопустимое значение phandle . Например, он может иметь значение NULL.

Комментарии

Примечания к вызывающим абонентам

Объект рисунка может сохранить владение рисунком. Однако вызывающий объект может быть уверен, что изображение останется действительным до тех пор, пока вызывающий объект не уничтожит изображение или сам объект рисунка не будет уничтожен. Параметр fOwn для OleCreatePictureIndirect определяет владение при создании объекта picture. OleLoadPicture принудительно возвращает значение TRUE.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

См. также раздел

IPicture