OleCreatePictureIndirect-Funktion (olectl.h)

Artikel
03/01/2024

Erstellt ein neues Bildobjekt, das gemäß einer PICTDESC-Struktur initialisiert wird.

Syntax

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

Parameter

[in] lpPictDesc

Zeiger auf eine vom Aufrufer zugeordnete Struktur, die den Anfangszustand des Bilds enthält. Die angegebene Struktur kann NULL sein, um ein nicht initialisiertes Objekt zu erstellen, falls das Bild über IPersistStream::Load initialisiert werden muss.

[in] riid

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

[in] fOwn

True gibt an, dass das Bildobjekt sein Bild zerstört, wenn das Objekt zerstört wird. Bei FALSE ist der Aufrufer für die Zerstörung des Bilds verantwortlich.

[out] lplpvObj

Adresse der Zeigervariablen, die den in riid angeforderten Schnittstellenzeiger empfängt. Bei erfolgreicher Rückgabe enthält dieser Parameter den angeforderten Schnittstellenzeiger für das neu erstellte Objekt. Wenn der Aufruf erfolgreich ist, ist der Aufrufer für den Aufruf von Release über diesen Schnittstellenzeiger verantwortlich, wenn das neue Objekt nicht mehr benötigt wird. Wenn der Aufruf fehlschlägt, wird der Wert 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 lplpvObj ist ungültig. Es kann z. B. NULL sein.

Hinweise

Der Parameter fOwn gibt an, ob das Bild den GDI-Bildhandle für das enthaltene Bild besitzen soll, sodass das Bildobjekt sein Bild zerstört, wenn das Objekt selbst zerstört wird. Die Funktion gibt einen Schnittstellenzeiger auf das neue Bildobjekt zurück, das vom Aufrufer im riid-Parameter angegeben wird. In diesen Aufruf ist eine QueryInterface integriert. Der Aufrufer ist für den Aufruf von Release über den zurückgegebenen Schnittstellenzeiger verantwortlich.

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

OleLoadPicture

PICTDESC

Freigeben über