OleCreateLink-Funktion (ole2.h)

Artikel
08/25/2023

Erstellt ein verknüpftes OLE-Verbunddokumentobjekt.

Syntax

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

Parameter

[in] pmkLinkSrc

Zeiger auf die IMoniker-Schnittstelle auf dem Moniker, der verwendet werden kann, um die Quelle des verknüpften Objekts zu suchen.

[in] riid

Verweis auf den Bezeichner der Schnittstelle, die der Aufrufer später für die Kommunikation mit dem neuen Objekt verwendet (in der Regel IID_IOleObject, definiert in den OLE-Headern als Schnittstellenbezeichner für IOleObject).

[in] renderopt

Gibt einen Wert aus der OLERENDER-Enumeration an, der die lokal zwischengespeicherten Zeichnungs- oder Datenabruffunktionen angibt, über die das neu erstellte Objekt verfügen soll. Weitere Überlegungen werden unten im Abschnitt "Hinweise" beschrieben.

[in] lpFormatEtc

Zeiger auf einen Wert aus der OLERENDER-Enumeration , der die lokal zwischengespeicherten Zeichnungs- oder Datenabruffunktionen angibt, über die das neu erstellte Objekt verfügen soll. Der ausgewählte OLERENDER-Wert wirkt sich auf die möglichen Werte für den lpFormatEtc-Parameter aus.

[in] pClientSite

Zeiger auf eine instance von IOleClientSite, der primären Schnittstelle, über die das Objekt Dienste von seinem Container anfordere. Dieser Parameter kann NULL sein.

[in] pStg

Zeiger auf die IStorage-Schnittstelle für das Speicherobjekt. Dieser Parameter darf nicht NULL sein.

[out] ppvObj

Adresse der Zeigervariablen, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvObj den angeforderten Schnittstellenzeiger für das neu erstellte Objekt.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
OLE_E_CANT_BINDTOSOURCE	Die Bindung an die Quelle ist nicht möglich.

Hinweise

Rufen Sie OleCreateLink auf, um einem Container das Erstellen einer Verknüpfung mit einem Objekt zu ermöglichen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ole2.h
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

IOleClientSite::GetMoniker

IOleObject::SetMoniker