Compartir a través de


Función OleLoadPicturePath (olectl.h)

Crea un nuevo objeto de imagen e inicializa a partir del contenido de una secuencia. Esto equivale a llamar a OleCreatePictureIndirect(NULL, ...) seguido de IPersistStream::Load.

Sintaxis

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

Parámetros

[in] szURLorPath

Ruta de acceso o dirección URL al archivo que desea abrir.

[in] punkCaller

Apunta a IUnknown para la agregación COM.

[in] dwReserved

Reservado.

[in] clrReserved

Color que desea reservar para que sea transparente.

[in] riid

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

[out] ppvRet

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvRet contiene el puntero de interfaz solicitado en el almacenamiento del objeto identificado por el moniker. Si *ppvRet 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, *ppvRet se establece en NULL.

Valor devuelto

Esta función admite los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes:

Código devuelto Descripción
S_OK
El cuadro de diálogo se creó correctamente.
E_FAIL
No se puede cargar la secuencia de imágenes.
E_POINTER
La dirección de ppvRet es NULL.
E_NOINTERFACE
El objeto no admite la interfaz especificada en riid.

Comentarios

La secuencia debe estar en formato BMP (mapa de bits), JPEG, WMF (metarchivo), ICO (icono) o GIF.

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

OleLoadPicture