Funzione EnumResourceTypesA (winbase.h)

Articolo
11/20/2024

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 mui), se presenti, che contengono risorse localizzabili della 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 di un modulo in cui eseguire la ricerca. Questo handle deve essere ottenuto tramite LoadLibrary o LoadLibraryEx.

Per altre 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 enumerato. 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 in caso di esito positivo; in caso contrario, FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 fino a quando la funzione di callback non restituisce FALSE o tutti i tipi di risorse 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 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ù in 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 mui, il tipo viene enumerato una sola volta.

Esempi

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 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	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll