OleCreatePictureIndirect, fonction (olectl.h)

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.

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

Voir aussi

OleLoadPicture

PICTDESC