Funzione OleCreatePictureIndirect (olectl.h)

Articolo
08/25/2023

Crea un nuovo oggetto immagine inizializzato in base a una struttura PICTDESC .

Sintassi

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

Parametri

[in] lpPictDesc

Puntatore a una struttura allocata del chiamante contenente lo stato iniziale dell'immagine. La struttura specificata può essere NULL per creare un oggetto non inizializzato, nel caso in cui l'immagine debba inizializzare tramite IPersistStream::Load.

[in] riid

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

[in] fOwn

Se TRUE, l'oggetto immagine deve distruggere l'immagine quando l'oggetto viene distrutto. Se FALSE, il chiamante è responsabile della eliminazione dell'immagine.

[out] lplpvObj

Indirizzo della variabile puntatore che riceve il puntatore dell'interfaccia richiesto in riid. Al termine della restituzione, questo parametro contiene il puntatore dell'interfaccia richiesto nell'oggetto appena creato. Se la chiamata ha esito positivo, il chiamante è responsabile della chiamata a Release tramite questo puntatore di interfaccia quando il nuovo oggetto non è più necessario. Se la chiamata ha esito negativo, il valore è 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 in riid.
E_POINTER	L'indirizzo in pPictDesc o lplpvObj non è valido. Ad esempio, può essere NULL.

Commenti

Il parametro fOwn indica se l'immagine è proprietaria dell'handle immagine GDI per l'immagine che contiene, in modo che l'oggetto immagine elimini l'immagine quando l'oggetto stesso viene distrutto. La funzione restituisce un puntatore dell'interfaccia al nuovo oggetto immagine specificato dal chiamante nel parametro riid . Una queryInterface è incorporata in questa chiamata. Il chiamante è responsabile della chiamata a Release tramite il puntatore dell'interfaccia restituito.

Requisiti

Requisito	Valore
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

PICTDESC