Compartir a través de

Función OleCreatePictureIndirect (olectl.h)

  • Artículo

Crea un nuevo objeto de imagen inicializado según una estructura PICTDESC .

Sintaxis

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

Parámetros

[in] lpPictDesc

Puntero a una estructura asignada por el autor de la llamada que contiene el estado inicial de la imagen. La estructura especificada puede ser NULL para crear un objeto sin inicializar, en caso de que la imagen tenga que inicializarse a través de IPersistStream::Load.

[in] riid

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

[in] fOwn

Si es TRUE, el objeto de imagen es destruir su imagen cuando se destruye el objeto. Si es FALSE, el autor de la llamada es responsable de destruir la imagen.

[out] lplpvObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, este parámetro contiene el puntero de interfaz solicitado en el objeto recién creado. Si la llamada se realiza correctamente, el autor de la llamada es responsable de llamar a Release a través de este puntero de interfaz cuando el nuevo objeto ya no es necesario. Si se produce un error en la llamada, el valor se establece en NULL.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son los siguientes.

Código devuelto Descripción
E_NOINTERFACE
 El objeto no admite la interfaz especificada en riid.
E_POINTER
 La dirección de pPictDesc o lplpvObj no es válida. Por ejemplo, puede ser NULL.

Comentarios

El parámetro fOwn indica si la imagen es propietaria del identificador de imagen GDI para la imagen que contiene, de modo que el objeto de imagen destruirá su imagen cuando se destruye el propio objeto. La función devuelve un puntero de interfaz al nuevo objeto de imagen especificado por el autor de la llamada en el parámetro riid . QueryInterface se integra en esta llamada. El autor de la llamada es responsable de llamar a Release a través del puntero de interfaz devuelto.

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

Consulte también

OleLoadPicture

PICTDESC