Funzione EnumResourceNamesExA (libloaderapi.h)
Enumera le risorse di un tipo specificato associate a un modulo binario specificato. La ricerca può includere sia un file LN che i relativi file mui associati oppure può essere limitato in diversi modi.
Sintassi
BOOL EnumResourceNamesExA(
[in, optional] HMODULE hModule,
LPCSTR lpType,
[in] ENUMRESNAMEPROCA lpEnumFunc,
[in] LONG_PTR lParam,
[in] DWORD dwFlags,
[in] LANGID LangId
);
Parametri
[in, optional] hModule
Tipo: HMODULE
Handle di un modulo da cercare. In genere si tratta di un file LN e, se il flag RESOURCE_ENUM_MUI è impostato, i file con estensione mui appropriati vengono inclusi nella ricerca. In alternativa, questo può essere un handle per un file mui o un altro file LN.
Se questo parametro è NULL, equivale a passare un handle al modulo usato per creare il processo corrente.
lpType
Tipo: LPCSTR
Tipo della risorsa per cui viene enumerato il nome. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è un valore intero che rappresenta un tipo di risorsa predefinito. Per un elenco dei tipi di risorse predefiniti, vedere Tipi di risorse. Per altre informazioni, vedere la sezione Osservazioni di seguito.
[in] lpEnumFunc
Tipo: ENUMRESNAMEPROC
Puntatore alla funzione di callback da chiamare per ogni nome di risorsa enumerato. Per altre informazioni, vedere EnumResNameProc.
[in] lParam
Tipo: LONG_PTR
Valore definito dall'applicazione passato alla funzione di callback. Questo parametro può essere usato nel controllo degli errori.
[in] dwFlags
Tipo: DWORD
Tipo di file da cercare. Sono supportati i valori seguenti. Si noti che se dwFlags è zero, si presuppone che vengano specificati i flag RESOURCE_ENUM_LN e RESOURCE_ENUM_MUI.
| Valore | Significato |
|---|---|
|
Cercare le risorse nei file con estensione mui associati al file LN specificato da hModule e con le preferenze di lingua correnti, seguendo la consueta strategia del caricatore delle risorse (vedere Gestione del linguaggio dell'interfaccia utente). In alternativa, se LangId è diverso da zero, verrà eseguita la ricerca solo del file con estensione mui specificato. In genere, questo flag deve essere usato solo se hModule fa riferimento a un file LN. Se hModule fa riferimento a un file mui, tale file è effettivamente coperto dal flag RESOURCE_ENUM_LN, nonostante il nome del flag. |
|
Cerca il file specificato da hModule, indipendentemente dal fatto che il file sia un file LN, un altro tipo di file LN o un file mui. |
|
Esegue una convalida aggiuntiva nella sezione della risorsa e il relativo riferimento nell'intestazione PE durante l'enumerazione per garantire che le risorse siano formattate correttamente. La convalida imposta un limite massimo di 260 caratteri per ogni nome enumerato. |
[in] LangId
Tipo: LANGID
Lingua di localizzazione usata per filtrare la ricerca nel modulo MUI. Questo parametro viene usato solo quando il flag di RESOURCE_ENUM_MUI è impostato in dwFlags. Se viene specificato zero, tutti i file con estensione mui che corrispondono alle preferenze di lingua correnti vengono inclusi nella ricerca, seguendo la consueta strategia di Resource Loader (vedere Gestione del linguaggio dell'interfaccia utente). Se viene specificato un langid diverso da zero, l'unico file mui cercato sarà quello corrispondente all'LangId specificato.
Valore restituito
Tipo: bool
La funzione TRUE se ha esito positivo oppure false se la funzione non trova una risorsa del tipo specificato oppure se la funzione non riesce per un altro motivo. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Se IS_INTRESOURCE(lpszType) è TRUE, lpszType specifica l'identificatore integer del tipo di risorsa specificato. In caso contrario, è un puntatore a una stringa con terminazione Null. Se il primo carattere della stringa è un segno di cancelletto (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'oggetto
identificatore integer del tipo di risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore 258.
La ricerca di enumerazione può includere sia un file LN che i relativi file mui associati. Può essere limitato a un singolo modulo binario di qualsiasi tipo. Può anche essere limitato ai file con estensione mui associati a un singolo file LN. Specificando un file LN per il parametro
Per ogni risorsa trovata, EnumResourceNamesEx chiama una funzione di callback definita dall'applicazione lpEnumFunc, passando il nome o l'ID di ogni risorsa trovata, nonché i vari altri parametri passati a EnumResourceNamesEx.
Se una risorsa ha un ID, l'ID viene restituito alla funzione di callback; in caso contrario, il nome della risorsa viene restituito alla funzione di callback. Per altre informazioni, vedere EnumResNameProc.
La funzione EnumResourceNamesEx
Se hModule specifica un file LN e vengono selezionati entrambi i flag, i nomi enumerati corrispondono alle risorse che risiedono nel file LN o nei file mui associati. Se non vengono trovati file con estensione mui, vengono restituiti solo i nomi del file LN. Dopo aver trovato un file mui appropriato, la ricerca non continuerà ulteriormente, perché tutti i file mui corrispondenti a un singolo file LN hanno gli stessi nomi di risorse.
Se dwFlags e LangId sono entrambi zero, la funzione si comporta come EnumResourceNames.
Se LangId è diverso da zero, verrà eseguita la ricerca solo del file mui corrispondente a tale identificatore di lingua. I fallback del linguaggio non verranno usati. Se non esiste un file mui per tale lingua, l'enumerazione sarà vuota (a meno che le risorse per tale lingua non esistano nel file LN e il flag sia impostato anche per la ricerca nel file LN).
L'enumerazione non include mai duplicati: se le risorse per una determinata lingua sono contenute sia nel file LN che in un file mui, il nome verrà enumerato una sola volta.
Esempi
Per un esempio, vedere Creazione di un elenco di risorse.
Nota
L'intestazione libloaderapi.h definisce EnumResourceNamesEx 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 Vista [solo app desktop] |
| server minimo supportato | Windows Server 2008 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
libloaderapi.h (include Windows.h) |
| libreria |
Kernel32.lib |
| dll | Kernel32.dll |
Vedere anche
concettuale
EnumResNameProc
riferimento
risorse