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 |
---|---|
|
El cuadro de diálogo se creó correctamente. |
|
No se puede cargar la secuencia de imágenes. |
|
La dirección de ppvRet es NULL. |
|
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 |