Función OleLoadPicture (olectl.h)

Crea un nuevo objeto de imagen e inicializa a partir del contenido de una secuencia. Esto equivale a llamar a OleCreatePictureIndirect con NULL como primer parámetro, seguido de una llamada a IPersistStream::Load.

Sintaxis

WINOLECTLAPI OleLoadPicture(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [out] LPVOID   *lplpvObj
);

Parámetros

[in] lpstream

Puntero a la secuencia que contiene los datos de la imagen.

[in] lSize

Número de bytes que se deben leer desde la secuencia o cero si se debe leer toda la secuencia.

[in] fRunmode

Lo contrario al valor inicial de la propiedad KeepOriginalFormat . Si es TRUE, KeepOriginalFormat se establece en FALSE y viceversa.

[in] riid

Referencia al identificador de la interfaz que describe el tipo de puntero de interfaz que se va a devolver en ppvObj.

[out] lplpvObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvObj contiene el puntero de interfaz solicitado en el almacenamiento del objeto identificado por el moniker. Si *ppvObj no es NULL, esta función llama a IUnknown::AddRef en la interfaz; es responsabilidad del autor de la llamada llamar a IUnknown::Release. Si se produce un error, *ppvObj se establece en NULL.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Código devuelto	Descripción
E_NOINTERFACE	El objeto no admite la interfaz especificada.
E_POINTER	La secuencia no es válida. Por ejemplo, puede ser NULL.

Comentarios

La secuencia debe estar en formato BMP (mapa de bits), WMF (metarchivo) o ICO (icono). Un objeto de imagen creado con OleLoadPicture siempre tiene la propiedad de sus recursos internos (fOwn==TRUE está implícito).

Requisitos

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	olectl.h
Library	OleAut32.lib
Archivo DLL	OleAut32.dll

Consulte también

OleCreatePictureIndirect

PICTDESC