Share via

OleLoadPicturePath-Funktion (olectl.h)

  • Artikel

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