Funzione EnumResourceTypesA (winbase.h)

Articolo
06/22/2023

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