OleLoadPicturePath, fonction (olectl.h)

Article
08/25/2023

Crée un objet image et l’initialise à partir du contenu d’un flux. Cela équivaut à appeler OleCreatePictureIndirect(NULL, ...) suivi de IPersistStream::Load.

Syntaxe

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

Paramètres

[in] szURLorPath

Chemin d’accès ou URL du fichier que vous souhaitez ouvrir.

[in] punkCaller

Pointe vers IUnknown pour l’agrégation COM.

[in] dwReserved

Réservé.

[in] clrReserved

Couleur que vous souhaitez réserver pour être transparente.

[in] riid

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

[out] ppvRet

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. En cas de retour réussi, *ppvRet contient le pointeur d’interface demandé sur le stockage de l’objet identifié par le moniker. Si *ppvRet 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, *ppvRet est défini sur NULL.

Valeur retournée

Cette fonction prend en charge les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les éléments suivants :

Code de retour	Description
S_OK	La boîte de dialogue a été créée avec succès.
E_FAIL	Impossible de charger le flux d’images.
E_POINTER	L’adresse dans ppvRet est NULL.
E_NOINTERFACE	L’objet ne prend pas en charge l’interface spécifiée dans riid.

Notes

Le flux doit être au format BMP (bitmap), JPEG, WMF (métafichier), ICO (icône) ou GIF.

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

OleLoadPicture

Partager via