OleLoadPicture-Funktion (olectl.h)

  • Artikel

Erstellt ein neues Bildobjekt und initialisiert es aus dem Inhalt eines Datenstroms. Dies entspricht dem Aufrufen von OleCreatePictureIndirect mit NULL als erstem Parameter, gefolgt von einem Aufruf von IPersistStream::Load.

Syntax

WINOLECTLAPI OleLoadPicture(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [out] LPVOID   *lplpvObj
);

Parameter

[in] lpstream

Zeiger auf den Stream, der die Daten des Bilds enthält.

[in] lSize

Die Anzahl der Bytes, die aus dem Stream gelesen werden sollen, oder null, wenn der gesamte Stream gelesen werden soll.

[in] fRunmode

Das Gegenteil des Anfangswerts der KeepOriginalFormat-Eigenschaft . Bei TRUE ist KeepOriginalFormat auf FALSE festgelegt und umgekehrt.

[in] riid

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

[out] lplpvObj

Adresse der Zeigervariable, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvObj den angeforderten Schnittstellenzeiger auf den Speicher des durch den Moniker identifizierten Objekts. Wenn *ppvObj 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 *ppvObj auf NULL festgelegt.

Rückgabewert

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

Rückgabecode Beschreibung
E_NOINTERFACE
 Das -Objekt unterstützt die angegebene Schnittstelle nicht.
E_POINTER
 Der Stream ist ungültig. Es kann z. B. NULL sein.

Hinweise

Der Stream muss im Format BMP (Bitmap), WMF (Metadatei) oder ICO (Symbol) vorliegen. Ein mit OleLoadPicture erstelltes Bildobjekt besitzt immer den Besitz seiner internen Ressourcen (fOwn==TRUE ist impliziert).

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

OleCreatePictureIndirect

PICTDESC