OleLoadPicture-Funktion (olectl.h)
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 |
|---|---|
|
Das -Objekt unterstützt die angegebene Schnittstelle nicht. |
|
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 |