OleLoadPictureEx-Funktion (olectl.h)

Artikel
03/06/2024

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

Syntax

WINOLECTLAPI OleLoadPictureEx(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [in]  DWORD    xSizeDesired,
  [in]  DWORD    ySizeDesired,
  [in]  DWORD    dwFlags,
  [out] LPVOID   *lplpvObj
);

Parameter

[in] lpstream

Zeiger auf den Datenstrom, 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 in ppvObj zurückzugebenden Schnittstellenzeigers beschreibt.

[in] xSizeDesired

Gewünschte Breite des Symbols oder Cursors. Gültige Werte sind 16, 32 und 48. Übergeben Sie LP_DEFAULT an beide Größenparameter, um die Standardgröße des Systems zu verwenden.

[in] ySizeDesired

Gewünschte Höhe des Symbols oder Cursors. Gültige Werte sind 16, 32 und 48. Übergeben Sie LP_DEFAULT an beide Größenparameter, um die Standardgröße des Systems zu verwenden.

[in] dwFlags

Gewünschte Farbtiefe für Symbol oder Cursor. Die Werte sind LP_MONOCHROME (monochrom), LP_VGACOLOR (16 Farben), LP_COLOR (256 Farben) oder LP_DEFAULT (wählt die beste Tiefe für die aktuelle Anzeige aus).

[out] lplpvObj

Adresse der Zeigervariablen, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvObj den angeforderten Schnittstellenzeiger für die Speicherung des durch den Moniker identifizierten Objekts. Wenn *ppvObj ungleich 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 S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
E_NOINTERFACE	Das -Objekt unterstützt die in riid angegebene Schnittstelle nicht.
E_POINTER	Die Adresse in pPictDesc oder ppvObj ist ungültig. Es kann z. B. NULL sein.

Hinweise

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

Zusätzlich zur Angabe der Symbol- oder Cursorgröße unterstützt OleLoadPictureEx das Laden von Farbcursorn.

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	olectl.h
Bibliothek	OleAut32.lib
DLL	OleAut32.dll

Weitere Informationen

OleCreatePictureIndirect

PICTDESC

Freigeben über