OleLoadPicture, fonction (olectl.h)

Crée un objet image et l’initialise à partir du contenu d’un flux. Cela revient à appeler OleCreatePictureIndirect avec NULL comme premier paramètre, suivi d’un appel à IPersistStream::Load.

Syntaxe

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

Paramètres

[in] lpstream

Pointeur vers le flux qui contient les données de l’image.

[in] lSize

Nombre d’octets à lire à partir du flux, ou zéro si le flux entier doit être lu.

[in] fRunmode

Opposé de la valeur initiale de la propriété KeepOriginalFormat . Si la valeur est TRUE, KeepOriginalFormat a la valeur FALSE et vice versa.

[in] riid

Référence à l’identificateur de l’interface décrivant le type de pointeur d’interface à retourner dans ppvObj.

[out] lplpvObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvObj contient le pointeur d’interface demandé sur le stockage de l’objet identifié par le moniker. Si *ppvObj n’a pas la valeur NULL, cette fonction appelle IUnknown::AddRef sur l’interface ; il incombe à l’appelant d’appeler IUnknown::Release. Si une erreur se produit, *ppvObj est défini sur NULL.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Notes

Le flux doit être au format BMP (bitmap), WMF (métafichier) ou ICO (icône). Un objet image créé à l’aide d’OleLoadPicture a toujours la propriété de ses ressources internes (fOwn==TRUE est implicite).

Spécifications

Voir aussi

OleCreatePictureIndirect

PICTDESC