Funzione OleLoadPicture (olectl.h)

Articolo
03/08/2023

Crea un nuovo oggetto immagine e lo inizializza dal contenuto di un flusso. Equivale a chiamare OleCreatePictureIndirect con NULL come primo parametro, seguito da una chiamata a IPersistStream::Load.

Sintassi

WINOLECTLAPI OleLoadPicture(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [out] LPVOID   *lplpvObj
);

Parametri

[in] lpstream

Puntatore al flusso contenente i dati dell'immagine.

[in] lSize

Numero di byte che devono essere letti dal flusso oppure zero se l'intero flusso deve essere letto.

[in] fRunmode

L'opposto del valore iniziale della proprietà KeepOriginalFormat . Se TRUE, KeepOriginalFormat è impostato su FALSE e viceversa.

[in] riid

Riferimento all'identificatore dell'interfaccia che descrive il tipo di puntatore di interfaccia da restituire in ppvObj.

[out] lplpvObj

Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore di interfaccia richiesto nella risorsa di archiviazione dell'oggetto identificato dal moniker. Se *ppvObj non è NULL, questa funzione chiama IUnknown::AddRef nell'interfaccia; è responsabilità del chiamante chiamare IUnknown::Release. Se si verifica un errore, *ppvObj è impostato su NULL.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
E_NOINTERFACE	L'oggetto non supporta l'interfaccia specificata.
E_POINTER	Il flusso non è valido. Ad esempio, può essere NULL.

Commenti

Il flusso deve essere in formato BMP (bitmap), WMF (metafile) o ICO (icona). Un oggetto immagine creato usando OleLoadPicture ha sempre la proprietà delle relative risorse interne (fOwn==TRUE è implicito).

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

OleCreatePictureIndirect

PICTDESC