Funzione EnumResourceLanguagesA (winbase.h)

Articolo
06/27/2024

Enumera le risorse specifiche del linguaggio, del tipo e del nome specificati, associate a un modulo binario.

Sintassi

BOOL EnumResourceLanguagesA(
  [in] HMODULE          hModule,
  [in] LPCSTR           lpType,
  [in] LPCSTR           lpName,
  [in] ENUMRESLANGPROCA lpEnumFunc,
  [in] LONG_PTR         lParam
);

Parametri

[in] hModule

Tipo: HMODULE

Handle di un modulo in cui eseguire la ricerca. A partire da Windows Vista, se si tratta di un file eseguibile portabile indipendente dal linguaggio ( file LN), i file con estensione mui appropriati (se presenti) vengono inclusi nella ricerca. Se si tratta di un file con estensione mui specifico, viene cercato solo il file per le risorse.

Se questo parametro è NULL, equivale a passare un handle al modulo usato per creare il processo corrente.

[in] lpType

Tipo: LPCTSTR

Tipo di risorsa per cui viene enumerata la lingua. 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] lpName

Tipo: LPCTSTR

Nome della risorsa per cui viene enumerata la lingua. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è l'identificatore integer della risorsa. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[in] lpEnumFunc

Tipo: ENUMRESLANGPROC

Puntatore alla funzione di callback da chiamare per ogni linguaggio di risorse enumerato. Per altre informazioni, vedere EnumResLangProcA.

[in] lParam

Tipo: LONG_PTR

Valore definito dall'applicazione passato alla funzione di callback. Questo parametro può essere usato nel controllo degli errori.

Valore restituito

Tipo: bool

Restituisce TRUE se ha esito positivo o false in caso contrario. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Se IS_INTRESOURCE(lpType) è TRUE, lpType 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'identificatore integer del tipo di risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore 258.

Analogamente, se IS_INTRESOURCE(lpName) è TRUE, lpName specifica l'identificatore intero della risorsa specificata. 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'identificatore intero della risorsa.

A partire da Windows Vista, il modulo binario è in genere un file eseguibile portabile indipendente dal linguaggio (file LN) e l'enumerazione includerà anche le risorse dei file di risorse specifici della lingua corrispondenti (file mui) che contengono risorse localizzabili del linguaggio.

Per ogni risorsa trovata, EnumResourceLanguages chiama una funzione di callback definita dall'applicazione lpEnumFunc, passando l'identificatore della lingua (vedere identificatori di lingua ) della lingua per cui è stata trovata una risorsa, nonché i vari altri parametri passati a EnumResourceLanguages.

In alternativa, le applicazioni possono chiamare EnumResourceLanguagesEx, che fornisce un controllo più preciso delle risorse enumerate.

La funzione EnumResourceLanguages continua ad enumerare le lingue delle risorse fino a quando la funzione di callback non restituisce FALSE o tutte le lingue delle risorse sono state enumerate.

In Windows Vista e versioni successive, se hModule specifica un file LN, le risorse enumerate possono risiedere nel file LN o in un file mui associato. Se non vengono trovati file con estensione mui, vengono restituite solo le risorse del file LN. A differenza di EnumResourceNames e EnumResourceTypes, questa ricerca esaminerà più file mui. L'enumerazione inizia con i file mui nelle cartelle associate a EnumUILanguages. Questi file sono seguiti da qualsiasi altro file mui i cui percorsi sono conformi allo schema descritto in MUI Resource Management. Viene infine eseguita la ricerca del file designato da hModule.

L'enumerazione non include mai duplicati: se una risorsa con lo stesso nome, tipo e lingua è contenuta sia nel file LN che in un file mui, la risorsa verrà enumerata una sola volta.

Esempi

Per un esempio, vedere Creazione di un elenco di risorse.

Nota

L'intestazione winbase.h definisce EnumResourceLanguages 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 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