OleCreatePictureIndirect-Funktion (olectl.h)

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:

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

Weitere Informationen

OleLoadPicture

PICTDESC