# OleCreateLink

Creates an OLE compound-document linked object.

WINOLEAPI OleCreateLink(

LPMONIKER pmkLinkSrc, | //Pointer to moniker indicating source of linked object
REFIID riid, | //Reference to the identifier of the interfacer to be used to communicate with the new object
DWORD renderopt, | //Value from OLERENDER
LPFORMATETC pFormatEtc, | //Pointer to a FORMATETC structure
LPOLECLIENTSITE pClientSite, | //Pointer to an interface
LPSTORAGE pStg, | //Pointer to the object’s storage
LPVOID FAR* ppvObj | //Indirect pointer to the interface requested in riid
); |

Parameters

pmkLinkSrc
  [in] Pointer to the IMoniker interface on the moniker that can be used to locate the the source of the linked object.
riid
  [in] Reference to the identifier of the interface the caller later uses to communicate with the new object (usually IID_IOleObject, defined in the OLE headers as the interface identifier for IOleObject).
renderopt
  [in] Specifies a value from the enumeration OLERENDER that indicates the locally cached drawing or data-retrieval capabilities the newly created object is to have. Additional considerations are described in the Remarks section below.
pFormatEtc
  [in] Pointer to a value from the enumeration OLERENDER that indicates the locally cached drawing or data-retrieval capabilities the newly created object is to have. The OLERENDER value chosen affects the possible values for the pFormatEtc parameter.
pClientSite
  [in] Pointer to an instance of IOleClientSite, the primary interface through which the object will request services from its container. May be NULL.
pStg
  [in] Pointer to the IStorage interface on the storage object. This parameter may not be NULL.
ppvObj
  [out] Indirect pointer to the interface requested in riid on the newly created object.

Return Values

S_OK
  The compound-document linked object was created successfully.
OLE_E_CANT_BINDTOSOURCE
  Not able to bind to source. Binding is necessary to get the cache’s initialization data.

Remarks

Call OleCreateLink to allow a container to create a link to an object.

See Also

IOleObject::SetMoniker, IOleClientSite::GetMoniker