OleLoadPicture, fonction (olectl.h)

Article
08/25/2023

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.

Code de retour	Description
E_NOINTERFACE	L’objet ne prend pas en charge l’interface spécifiée.
E_POINTER	Le flux n’est pas valide. Par exemple, il peut s’agir de NULL.

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


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	olectl.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll

Voir aussi

OleCreatePictureIndirect

PICTDESC