OleCreatePictureIndirect, fonction (olectl.h)

Article
03/04/2024

Crée un objet image initialisé selon une structure PICTDESC .

Syntaxe

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

Paramètres

[in] lpPictDesc

Pointeur vers une structure allouée à l’appelant contenant l’état initial de l’image. La structure spécifiée peut avoir la valeur NULL pour créer un objet non initialisé, dans le cas où l’image doit être initialisée via IPersistStream ::Load.

[in] riid

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

[in] fOwn

Si la valeur est TRUE, l’objet image doit détruire son image lorsque l’objet est détruit. Si la valeur est FALSE, l’appelant est responsable de la destruction de l’image.

[out] lplpvObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. En cas de retour réussi, ce paramètre contient le pointeur d’interface demandé sur l’objet nouvellement créé. Si l’appel réussit, l’appelant est responsable de l’appel de Release via ce pointeur d’interface lorsque le nouvel objet n’est plus nécessaire. Si l’appel échoue, la valeur est définie 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 dans riid.
E_POINTER	L’adresse dans pPictDesc ou lplpvObj n’est pas valide. Par exemple, il peut être NULL.

Remarques

Le paramètre fOwn indique si l’image doit posséder le handle d’image GDI pour l’image qu’elle contient, de sorte que l’objet image détruit son image lorsque l’objet lui-même est détruit. La fonction retourne un pointeur d’interface vers le nouvel objet image spécifié par l’appelant dans le paramètre riid . Un QueryInterface est intégré à cet appel. L’appelant est responsable de l’appel de Release via le pointeur d’interface retourné.

Configuration requise

Condition requise	Valeur
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

OleLoadPicture

PICTDESC

Partager via