Funzione OleLoadPicturePath (olectl.h)
Crea un nuovo oggetto immagine e lo inizializza dal contenuto di un flusso. Equivale a chiamare OleCreatePictureIndirect(NULL, ...) seguito da IPersistStream::Load.
Sintassi
WINOLECTLAPI OleLoadPicturePath(
[in] LPOLESTR szURLorPath,
[in] LPUNKNOWN punkCaller,
[in] DWORD dwReserved,
[in] OLE_COLOR clrReserved,
[in] REFIID riid,
[out] LPVOID *ppvRet
);
Parametri
[in] szURLorPath
Percorso o URL del file da aprire.
[in] punkCaller
Punta a IUnknown per l'aggregazione COM.
[in] dwReserved
Riservato.
[in] clrReserved
Colore che si desidera riservare per essere trasparente.
[in] riid
Riferimento all'identificatore dell'interfaccia che descrive il tipo di puntatore di interfaccia da restituire in ppvRet.
[out] ppvRet
Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvRet contiene il puntatore di interfaccia richiesto nella risorsa di archiviazione dell'oggetto identificato dal moniker. Se *ppvRet non è NULL, questa funzione chiama IUnknown::AddRef sull'interfaccia; è responsabilità del chiamante chiamare IUnknown::Release. Se si verifica un errore, *ppvRet è impostato su NULL.
Valore restituito
Questa funzione supporta i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i seguenti:
Codice restituito | Descrizione |
---|---|
|
La finestra di dialogo è stata creata correttamente. |
|
Impossibile caricare il flusso di immagini. |
|
L'indirizzo in ppvRet è NULL. |
|
L'oggetto non supporta l'interfaccia specificata in riid. |
Commenti
Il flusso deve essere in formato BMP (bitmap), JPEG, WMF (metafile), ICO (icona) o GIF.
Requisiti
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | olectl.h |
Libreria | OleAut32.lib |
DLL | OleAut32.dll |