Método IPicture::get_Handle (ocidl.h)

  • Artículo

Recupera el identificador de la imagen administrada dentro de este objeto de imagen en una ubicación especificada.

Sintaxis

HRESULT get_Handle(
  [out] OLE_HANDLE *pHandle
);

Parámetros

[out] pHandle

Puntero a una variable que recibe el identificador. El autor de la llamada es responsable de este identificador tras la devolución correcta. La variable se establece en NULL en caso de error.

Valor devuelto

Este método admite los valores devueltos estándar E_FAIL y E_OUTOFMEMORY, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El identificador se devolvió correctamente.
E_POINTER
 El valor de phandle no es válido. Por ejemplo, puede ser NULL.

Comentarios

Notas a los autores de llamadas

El objeto picture puede conservar la propiedad de la imagen. Sin embargo, el autor de la llamada puede estar seguro de que la imagen permanecerá válida hasta que el autor de la llamada destruya específicamente la imagen o el objeto de imagen se destruya. El parámetro fOwn de OleCreatePictureIndirect determina la propiedad cuando se crea el objeto de imagen. OleLoadPicture fuerza fOwn a TRUE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IPicture