Funzione OleLoadPicturePath (olectl.h)

Articolo
08/25/2023

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
S_OK	La finestra di dialogo è stata creata correttamente.
E_FAIL	Impossibile caricare il flusso di immagini.
E_POINTER	L'indirizzo in ppvRet è NULL.
E_NOINTERFACE	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

Vedi anche

OleLoadPicture