Metodo IPicture::get_hPal (ocidl.h)

Recupera una copia della tavolozza attualmente usata dall'oggetto immagine.

Sintassi

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

Parametri

[out] phPal

Puntatore a una variabile che riceve l'handle della tavolozza. La variabile è impostata su NULL in caso di errore.

Valore restituito

Questo metodo supporta i valori restituiti standard E_FAIL e E_OUTOFMEMORY, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	L'altezza è stata restituita correttamente.
S_FALSE	Questa immagine non ha tavolozza. Variabile che punta a phpal impostata su NULL.
E_POINTER	Il valore di phPal non è valido. Ad esempio, può essere NULL.

Commenti

Note ai chiamanti

Se l'oggetto immagine ha la proprietà dell'immagine, ha anche la proprietà della tavolozza e lo distruggerà quando l'oggetto viene distrutto. In caso contrario, il chiamante possiede la tavolozza. Il parametro fOwn in OleCreatePictureIndirect determina la proprietà. OleLoadPicture imposta fOwn su TRUE per indicare che l'oggetto immagine possiede la tavolozza.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IPicture