funzione Shell_GetCachedImageIndexA (shlobj_core.h)

Articolo
11/20/2024

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

Recupera l'indice della cache di un'icona memorizzata nella cache.

Sintassi

int Shell_GetCachedImageIndexA(
  LPCSTR pszIconPath,
  int    iIconIndex,
  UINT   uIconFlags
);

Parametri

pszIconPath

TBD

iIconIndex

Tipo: int

Indice dell'immagine all'interno del file denominato in pwszIconPath.

uIconFlags

Tipo: UINT

Non utilizzato.

Valore restituito

Tipo: int

Restituisce l'indice dell'immagine o –1 in caso di errore.

Osservazioni

Le versioni Shell_GetCachedImageIndexA e Shell_GetCachedImageIndexW di questa funzione sono state aggiunte in Windows Vista. Per le stringhe Unicode, chiamare Shell_GetCachedImageIndexW o Shell_GetCachedImageIndex. Per le stringhe ANSI, è necessario chiamare Shell_GetCachedImageIndexA in modo esplicito.

Windows Server 2003 e Windows XP: è supportato solo Shell_GetCachedImageIndex. Shell_GetCachedImageIndex richiede una stringa Unicode.

Nota

L'intestazione shlobj_core.h definisce Shell_GetCachedImageIndex come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlobj_core.h (include Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 5.0 o successiva)
set di API	ext-ms-win-shell-shell32-l1-2-1 (introdotto in Windows 10, versione 10.0.10240)

Vedere anche

FileIconInit

Condividi tramite