OleLoadPicturePath-Funktion (olectl.h)

Artikel
08/25/2023

Erstellt ein neues Bildobjekt und initialisiert es aus dem Inhalt eines Datenstroms. Dies entspricht dem Aufrufen von OleCreatePictureIndirect(NULL, ...) gefolgt von IPersistStream::Load.

Syntax

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

Parameter

[in] szURLorPath

Der Pfad oder die URL der Datei, die Sie öffnen möchten.

[in] punkCaller

Zeigt auf IUnknown für COM-Aggregation.

[in] dwReserved

Reserviert.

[in] clrReserved

Die Farbe, die Sie reservieren möchten, um transparent zu sein.

[in] riid

Verweis auf den Bezeichner der Schnittstelle, die den Typ des zurückzugebenden Schnittstellenzeigers in ppvRet beschreibt.

[out] ppvRet

Adresse der Zeigervariable, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvRet den angeforderten Schnittstellenzeiger auf den Speicher des vom Moniker identifizierten Objekts. Wenn *ppvRet nicht NULL ist, ruft diese Funktion IUnknown::AddRef auf der Schnittstelle auf. Es liegt in der Verantwortung des Aufrufers , IUnknown::Release aufzurufen. Wenn ein Fehler auftritt, wird *ppvRet auf NULL festgelegt.

Rückgabewert

Diese Funktion unterstützt die Standardrückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Das Dialogfeld wurde erfolgreich erstellt.
E_FAIL	Bilddatenstrom kann nicht geladen werden.
E_POINTER	Die Adresse in ppvRet ist NULL.
E_NOINTERFACE	Das -Objekt unterstützt die in riid angegebene Schnittstelle nicht.

Hinweise

Der Stream muss im Format BMP (Bitmap), JPEG, WMF (Metadatei), ICO (Symbol) oder GIF vorliegen.

Anforderungen


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

Weitere Informationen

OleLoadPicture

Freigeben über