Funzione SHMapPIDLToSystemImageListIndex (shlobj_core.h)

[SHMapPIDLToSystemImageListIndex è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Recupera l'indice dell'icona dall'elenco di immagini di sistema associato a un elemento della cartella.

Sintassi

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

Parametri

[in] pshf

Tipo: IShellFolder*

Puntatore all'interfaccia IShellFolder per la cartella che contiene l'elemento.

[in] pidl

Tipo: PCUITEMID_CHILD

Puntatore alla struttura ITEMIDLIST dell'elemento.

[out, optional] piIndexSel

Tipo: int*

Puntatore a un valore int che, quando questa funzione viene restituita correttamente, riceve l'indice dell'icona aperta dell'elemento nell'elenco di immagini di sistema. Se l'elemento non ha un'icona aperta speciale, viene restituito l'indice dell'icona normale. Se l'icona aperta esiste e non può essere ottenuta, il valore a cui punta piIndex è impostato su -1. Questo parametro può essere NULL se l'applicazione chiamante non è interessata all'icona aperta .

Valore restituito

Tipo: int

Restituisce l'indice dell'icona normale dell'elemento nell'elenco di immagini di sistema se l'operazione ha esito positivo o -1 in caso contrario.

Requisiti