Funzione PrivateExtractIconsA (winuser.h)

Articolo
11/20/2024

[Questa funzione non è destinata all'uso generale. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Crea una matrice di handle per le icone estratte da un file specificato.

Sintassi

UINT PrivateExtractIconsA(
  [in]            LPCSTR szFileName,
  [in]            int    nIconIndex,
  [in]            int    cxIcon,
  [in]            int    cyIcon,
  [out, optional] HICON  *phicon,
  [out, optional] UINT   *piconid,
  [in]            UINT   nIcons,
  [in]            UINT   flags
);

Parametri

[in] szFileName

Tipo: LPCTSTR

Percorso e nome del file da cui estrarre le icone.

[in] nIconIndex

Tipo: int

Indice in base zero della prima icona da estrarre. Ad esempio, se questo valore è zero, la funzione estrae la prima icona nel file specificato.

[in] cxIcon

Tipo: int

Dimensioni dell'icona orizzontale desiderate. Vedere la sezione Osservazioni.

[in] cyIcon

Tipo: int

Dimensioni dell'icona verticale desiderate. Vedere la sezione Osservazioni.

[out, optional] phicon

Tipo: HICON*

Puntatore alla matrice restituita di handle icona.

[out, optional] piconid

Tipo: UINT*

Puntatore a un identificatore di risorsa restituito per l'icona più adatta al dispositivo di visualizzazione corrente. L'identificatore restituito è 0xFFFFFFFF se l'identificatore non è disponibile per questo formato. L'identificatore restituito è 0 se l'identificatore non può essere altrimenti ottenuto.

[in] nIcons

Tipo: UINT

Numero di icone da estrarre dal file. Questo parametro è valido solo quando si estrae da .exe e .dll file.

[in] flags

Tipo: UINT

Specifica i flag che controllano questa funzione. Questi flag sono i flag LR_* usati dalla funzione LoadImage .

Valore restituito

Tipo: UINT

Se il parametro phicon è NULL e questa funzione ha esito positivo, il valore restituito è il numero di icone nel file. Se la funzione ha esito negativo, il valore restituito è 0.

Se il parametro phicon non è NULL e la funzione ha esito positivo, il valore restituito è il numero di icone estratte. In caso contrario, il valore restituito è 0xFFFFFFFF se il file non viene trovato.

Osservazioni

Questa funzione estrae da file eseguibili (.exe), DLL (.dll), icona (.ico), cursore (.cur), cursore animato (.ani) e bitmap (.bmp). Sono supportate anche le estrazione da eseguibili a 16 bit (.exe o .dll) di Windows 3.x.

I parametri cxIcon e cyIcon specificano le dimensioni delle icone da estrarre. È possibile estrarre due dimensioni inserendo la prima dimensione nel LOWORD del parametro e la seconda dimensione nell'HIWORD. Ad esempio, MAKELONG(24, 48) per entrambi i parametri cxIcon e cyIcon estraerebbero sia icone di dimensioni 24 che 48.

È necessario eliminare tutte le icone estratte da PrivateExtractIcons chiamando la funzione DestroyIcon.

Questa funzione non è stata inclusa nelle intestazioni e nelle librerie SDK fino a Windows XP Service Pack 1 (SP1) e Windows Server 2003. Se non si dispone di un file di intestazione e di una libreria di importazione per questa funzione, è possibile chiamare la funzione usando LoadLibrary e GetProcAddress.

Nota

L'intestazione winuser.h definisce PrivateExtractIcons 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 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h
libreria	User32.lib
dll	User32.dll
set di API	ext-ms-win-ntuser-misc-l1-5-1 (introdotto in Windows 10, versione 10.0.14393)