OleCreateFromFile-Funktion (ole.h)

Artikel
03/04/2024

Erstellt ein eingebettetes Objekt aus dem Inhalt einer benannten Datei.

Syntax

OLESTATUS OleCreateFromFile(
  LPCSTR        unnamedParam1,
  LPOLECLIENT   unnamedParam2,
  LPCSTR        unnamedParam3,
  LPCSTR        unnamedParam4,
  LHCLIENTDOC   unnamedParam5,
  LPCSTR        unnamedParam6,
  LPOLEOBJECT   *unnamedParam7,
  OLEOPT_RENDER unnamedParam8,
  OLECLIPFORMAT unnamedParam9
);

Parameter

unnamedParam1

TBD

unnamedParam2

TBD

unnamedParam3

TBD

unnamedParam4

TBD

unnamedParam5

TBD

unnamedParam6

TBD

unnamedParam7

TBD

unnamedParam8

TBD

unnamedParam9

TBD

Rückgabewert

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

Rückgabecode	Beschreibung
STG_E_FILENOTFOUND	Datei nicht gebunden.
OLE_E_CANT_BINDTOSOURCE	Eine Bindung an die Quelle ist nicht möglich.
STG_E_MEDIUMFULL	Das Medium ist voll.
DV_E_TYMED	Ungültiges TYMED.
DV_E_LINDEX	Ungültige LINDEX.
DV_E_FORMATETC	Ungültige FORMATTC-Struktur.

Hinweise

Die OleCreateFromFile-Funktion erstellt ein neues eingebettetes Objekt aus dem Inhalt einer benannten Datei. Wenn die ProgID in der Registrierungsdatenbank den Schlüssel PackageOnFileDrop enthält, wird ein Paket erstellt. Andernfalls ruft die Funktion GetClassFile auf, um die CLSID abzurufen, die dem lpszFileName-Parameter zugeordnet ist, und erstellt dann ein dieser CLSID zugeordnetes OLE 2-eingebettetes Objekt. Der rclsid-Parameter von OleCreateFromFile wird immer ignoriert und sollte auf CLSID_NULL festgelegt werden.

Wie bei anderen OleCreateXxx-Funktionen wird das neu erstellte Objekt dem Benutzer nicht zur Bearbeitung angezeigt, was einen DoVerb-Vorgang erfordert. Es wird verwendet, um Einfügedateivorgänge zu implementieren.

Anforderungen

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

Weitere Informationen

GetClassFile

Freigeben über