Funzione EnumResourceTypesA (winbase.h)
Enumera i tipi di risorse all'interno di un modulo binario. A partire da Windows Vista, si tratta in genere di un file eseguibile portabile indipendente dal linguaggio (file LN) e l'enumerazione include anche le risorse di uno dei file di risorse specifici della lingua corrispondenti (file con estensione mui), se presente, che contengono risorse localizzabili per la lingua. È anche possibile usare hModule per specificare un file mui, nel qual caso viene eseguita solo la ricerca di tipi di risorse.
In alternativa, le applicazioni possono chiamare EnumResourceTypesEx, che fornisce un controllo più preciso sui file di risorse da enumerare.
Sintassi
BOOL EnumResourceTypesA(
[in, optional] HMODULE hModule,
[in] ENUMRESTYPEPROCA lpEnumFunc,
[in] LONG_PTR lParam
);
Parametri
[in, optional] hModule
Tipo: HMODULE
Handle per un modulo da cercare. Questo handle deve essere ottenuto tramite LoadLibrary o LoadLibraryEx.
Per ulteriori informazioni, vedere la sezione Osservazioni.
Se questo parametro è NULL, equivale a passare un handle al modulo usato per creare il processo corrente.
[in] lpEnumFunc
Tipo: ENUMRESTYPEPROC
Puntatore alla funzione di callback da chiamare per ogni tipo di risorsa enumerata. Per altre informazioni, vedere la funzione EnumResTypeProc .
[in] lParam
Tipo: LONG_PTR
Valore definito dall'applicazione passato alla funzione di callback.
Valore restituito
Tipo: BOOL
Restituisce TRUE se l'operazione riesce; in caso contrario, FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Per ogni tipo di risorsa trovato, EnumResourceTypes chiama una funzione di callback definita dall'applicazione lpEnumFunc, passando ogni tipo di risorsa trovato, nonché i vari altri parametri passati a EnumResourceTypes.
EnumResourceTypes continua a enumerare i tipi di risorse finché la funzione di callback restituisce FALSE o tutti i tipi di risorse non sono stati enumerati.
A partire da Windows Vista, se hModule specifica un file LN, i tipi enumerati corrispondono alle risorse che risiedono nel file LN e nel file mui associato. Se non vengono trovati file con estensione mui, vengono restituiti solo i tipi del file LN. L'ordine in cui vengono cercati i file con estensione mui è il solito ordine di ricerca di Resource Loader; per informazioni dettagliate, vedere Gestione del linguaggio dell'interfaccia utente . Dopo aver trovato un file mui appropriato, la ricerca non continua più ad altri file mui associati al file LN, perché tutti i file mui che corrispondono a un singolo file LN hanno lo stesso set di tipi di risorse.
L'enumerazione non include mai duplicati: se un determinato tipo di risorsa è contenuto sia nel file LN che in un file con estensione mui, il tipo viene enumerato una sola volta.
Esempio
Per un esempio, vedere Creazione di un elenco di risorse.
Nota
L'intestazione winbase.h definisce EnumResourceTypes 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 | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |
Vedere anche
Informazioni concettuali
Riferimento