Funzione PrivateExtractIconsW (winuser.h)

Articolo
08/27/2023

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

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

Sintassi

UINT PrivateExtractIconsW(
  [in]            LPCWSTR 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 viene 0xFFFFFFFF se il file non viene trovato.

Commenti

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

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 estraggono 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 dell'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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	Winuser
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)