IPicture::get_hPal-Methode (ocidl.h)

  • Artikel

Ruft eine Kopie der Palette ab, die derzeit vom Bildobjekt verwendet wird.

Syntax

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

Parameter

[out] phPal

Ein Zeiger auf eine Variable, die das Palettenhandle empfängt. Die Variable ist bei Einem Fehler auf NULL festgelegt.

Rückgabewert

Diese Methode unterstützt die standardmäßigen Rückgabewerte E_FAIL und E_OUTOFMEMORY sowie die folgenden Werte.

Rückgabecode BESCHREIBUNG
S_OK
 Die Höhe wurde erfolgreich zurückgegeben.
S_FALSE
 Dieses Bild weist keine Palette auf. Die Variable, auf die phpal zeigt, wurde auf NULL festgelegt.
E_POINTER
 Der Wert von phPal ist ungültig. Es kann z. B. NULL sein.

Hinweise

Hinweise für Anrufer

Wenn das Bildobjekt den Besitz des Bilds hat, besitzt es auch den Besitz der Palette und zerstört es, wenn das Objekt selbst zerstört wird. Andernfalls besitzt der Aufrufer die Palette. Der fOwn-Parameter für OleCreatePictureIndirect bestimmt den Besitz. OleLoadPicture legt fOwn auf TRUE fest, um anzugeben, dass das Bildobjekt die Palette besitzt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

Ipicture