OleLoadPicturePath-Funktion (olectl.h)

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:

Hinweise

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

Anforderungen

Weitere Informationen

OleLoadPicture