Funzione OleCreateLink (ole2.h)

Crea un oggetto collegato al documento composto OLE.

Sintassi

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

Parametri

[in] pmkLinkSrc

Puntatore all'interfaccia IMoniker nel moniker che può essere usato per individuare l'origine dell'oggetto collegato.

[in] riid

Riferimento all'identificatore dell'interfaccia utilizzata successivamente dal chiamante per comunicare con il nuovo oggetto (in genere IID_IOleObject, definito nelle intestazioni OLE come identificatore di interfaccia per IOleObject).

[in] renderopt

Specifica un valore dell'enumerazione OLERENDER che indica le funzionalità di disegno o recupero dati memorizzate nella cache locale dell'oggetto appena creato. Le considerazioni aggiuntive sono descritte nella sezione Osservazioni di seguito.

[in] lpFormatEtc

Puntatore a un valore dell'enumerazione OLERENDER che indica le funzionalità di disegno o recupero dati memorizzate nella cache locale dell'oggetto appena creato. Il valore OLERENDER scelto influisce sui valori possibili per il parametro lpFormatEtc .

[in] pClientSite

Puntatore a un'istanza di IOleClientSite, interfaccia primaria tramite cui l'oggetto richiederà i servizi dal contenitore. Questo parametro può essere NULL.

[in] pStg

Puntatore all'interfaccia IStorage nell'oggetto di archiviazione. Questo parametro non può essere NULL.

[out] ppvObj

Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore di interfaccia richiesto nell'oggetto appena creato.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
OLE_E_CANT_BINDTOSOURCE	Non è possibile eseguire l'associazione all'origine.

Commenti

Chiamare OleCreateLink per consentire a un contenitore di creare un collegamento a un oggetto .

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

IOleClientSite::GetMoniker

IOleObject::SetMoniker