Partager via


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.

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