Metodo IShellIconOverlay::GetOverlayIconIndex (shlobj_core.h)

Ottiene l'indice della sovrapposizione dell'icona nell'elenco di immagini di sistema.

Sintassi

HRESULT GetOverlayIconIndex(
  [in]      PCUITEMID_CHILD pidl,
  [in, out] int             *pIconIndex
);

Parametri

[in] pidl

Tipo: PCUITEMID_CHILD

Puntatore a una struttura ITEMIDLIST che identifica l'oggetto la cui icona viene visualizzata.

[in, out] pIconIndex

Tipo: int*

Puntatore all'indice dell'immagine di sovrapposizione dell'icona nell'elenco di immagini di sistema. Questo indice equivale al valore iImage specificato quando si aggiunge un'immagine di sovrapposizione a un elenco di immagini private con la funzione ImageList::SetOverlayImage .

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
L'indice di una sovrapposizione è stato trovato.
S_FALSE
Nessuna sovrapposizione per questo file.
E_FAIL
PiDL non è valido.

Commenti

Per recuperare l'indice dell'immagine di sovrapposizione nell'elenco di immagini di sistema, è prima necessario chiamare SHGetIconOverlayIndex per recuperare l'indice di sovrapposizione. Usare quindi la macro INDEXTOOVERLAYMASK per convertire l'indice di sovrapposizione nell'indice di immagine equivalente.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h
DLL Shell32.dll (versione 5.0 o successiva)

Vedi anche

IShellIconOverlay