Méthode IPicture ::get_Handle (ocidl.h)

Article
02/29/2024

Récupère le handle de l’image gérée dans cet objet image à un emplacement spécifié.

Syntaxe

HRESULT get_Handle(
  [out] OLE_HANDLE *pHandle
);

Paramètres

[out] pHandle

Pointeur vers une variable qui reçoit le handle. L’appelant est responsable de ce handle en cas de retour réussi. La variable est définie sur NULL en cas d’échec.

Valeur retournée

Cette méthode prend en charge les valeurs de retour standard E_FAIL et E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	Le handle a été retourné avec succès.
E_POINTER	La valeur de phandle n’est pas valide. Par exemple, il peut s’agir de NULL.

Remarques

Remarques aux appelants

L’objet image peut conserver la propriété de l’image. Toutefois, l’appelant peut être assuré que l’image restera valide jusqu’à ce que l’appelant détruise spécifiquement l’image ou que l’objet image soit lui-même détruit. Le paramètre fOwn pour OleCreatePictureIndirect détermine la propriété lors de la création de l’objet image. OleLoadPicture force fOwn à TRUE.

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	ocidl.h

Voir aussi

IPicture

Partager via