OleCreateLinkToFile-Funktion (ole2.h)

Artikel
08/25/2023

Erstellt ein Objekt, das mit einer Datei verknüpft ist.

Syntax

HRESULT OleCreateLinkToFile(
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Parameter

[in] lpszFileName

Zeiger auf eine Zeichenfolge mit dem Namen der Quelldatei, mit der verknüpft werden soll.

[in] riid

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

[in] renderopt

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

[in] lpFormatEtc

Zeiger auf einen Wert aus der Enumeration OLERENDER , 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 pFormatEtc-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 Zeigervariable, 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 bei Erfolg S_OK zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
STG_E_FILENOTFOUND	Der Dateiname ist ungültig.
OLE_E_CANT_BINDTOSOURCE	Eine Bindung an die Quelle ist nicht möglich.

Hinweise

Die OleCreateLinkToFile-Funktion unterscheidet sich von der OleCreateLink-Funktion , da sie Links sowohl zu Dateien erstellen kann, die OLE nicht kennen, als auch zu dateien, die den Windows-Paketierer verwenden.

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

OleCreateLink