OleCreateLink, fonction (ole2.h)

Article
08/25/2023

Crée un objet lié de document composé OLE.

Syntaxe

HRESULT OleCreateLink(
  [in]  LPMONIKER       pmkLinkSrc,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Paramètres

[in] pmkLinkSrc

Pointeur vers l’interface IMoniker sur le moniker qui peut être utilisé pour localiser la source de l’objet lié.

[in] riid

Référence à l’identificateur de l’interface que l’appelant utilise ultérieurement pour communiquer avec le nouvel objet (généralement IID_IOleObject, défini dans les en-têtes OLE comme identificateur d’interface pour IOleObject).

[in] renderopt

Spécifie une valeur de l’énumération OLERENDER qui indique les fonctionnalités de dessin ou de récupération de données mises en cache localement que l’objet nouvellement créé doit avoir. D’autres considérations sont décrites dans la section Remarques ci-dessous.

[in] lpFormatEtc

Pointeur vers une valeur de l’énumération OLERENDER qui indique les fonctionnalités de dessin ou de récupération de données mises en cache localement que l’objet nouvellement créé doit avoir. La valeur OLERENDER choisie affecte les valeurs possibles pour le paramètre lpFormatEtc .

[in] pClientSite

Pointeur vers un instance de IOleClientSite, l’interface principale via laquelle l’objet demande des services à partir de son conteneur. Ce paramètre peut être NULL.

[in] pStg

Pointeur vers l’interface IStorage sur l’objet de stockage. Ce paramètre ne peut pas avoir la valeur NULL.

[out] ppvObj

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 l’objet nouvellement créé.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour	Description
OLE_E_CANT_BINDTOSOURCE	Impossible de lier à la source.

Notes

Appelez OleCreateLink pour permettre à un conteneur de créer un lien vers un objet.

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	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

IOleClientSite::GetMoniker

IOleObject::SetMoniker

Partager via