Condividi tramite


Funzione di callback ENUMRESLANGPROCA (libloaderapi.h)

Funzione callback definita dall'applicazione usata con le funzioni EnumResourceLanguagesA e EnumResourceLanguagesExA. Riceve il tipo, il nome e la lingua di un elemento di risorsa. Il tipo ENUMRESLANGPROC definisce un puntatore a questa funzione di callback. EnumResLangProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

BOOL CALLBACK EnumResLangProc(
  _In_opt_ HMODULE  hModule,
  _In_     LPCSTR  lpszType,
  _In_     LPCSTR  lpszName,
  _In_     WORD     wIDLanguage,
  _In_     LONG_PTR lParam
);

Sintassi

ENUMRESLANGPROCA Enumreslangproca;

BOOL Enumreslangproca(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR lpType,
  [in]           LPCSTR lpName,
  [in]           WORD wLanguage,
  [in]           LONG_PTR lParam
)
{...}

Parametri

[in, optional] hModule

Tipo: HMODULE

Handle al modulo il cui file eseguibile contiene le risorse per cui vengono enumerate le lingue. Se questo parametro è NULL, la funzione enumera i linguaggi delle risorse nel modulo usato per creare il processo corrente.

[in] lpType

Tipo: LPCSTR

Tipo di risorsa per cui viene enumerata la lingua. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è un valore integer che rappresenta un tipo di risorsa predefinito. Per i tipi di risorse standard, vedere Tipi di risorse. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[in] lpName

Tipo: LPCSTR

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

[in] wLanguage

Tipo: WORD

Identificatore della lingua per la risorsa per cui viene enumerata la lingua. La funzione EnumResourceLanguagesA o EnumResourceLanguagesExA fornisce questo valore. Per un elenco degli identificatori di lingua primaria e degli identificatori di sottolanguage che costituiscono un identificatore di lingua, vedere MAKELANGID.

[in] lParam

Tipo: LONG_PTR

Il parametro definito dall'applicazione passato alla funzione EnumResourceLanguagesA o EnumResourceLanguagesExA . Questo parametro può essere usato nel controllo degli errori.

Valore restituito

Tipo: BOOL

Restituisce TRUE per continuare l'enumerazione o FALSE per arrestare l'enumerazione.

Commenti

Se IS_INTRESOURCE(lpszType) è TRUE, lpszType specifica l'identificatore intero 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 sterlina (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'identificatore intero del tipo di risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore 258.

Analogamente, se IS_INTRESOURCE(lpszName) è TRUE, lpszName 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 sterlina (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'identificatore intero della risorsa.

Un'applicazione deve registrare questa funzione passando l'indirizzo alla funzione EnumResourceLanguagesA o EnumResourceLanguagesExA .

Se la funzione callback restituisce FALSE, EnumResourceLanguagesA o EnumResourceLanguagesExA arresterà l'enumerazione e restituirà FALSE. Il valore ottenuto da GetLastError sarà ERROR_RESOURCE_ENUM_USER_STOP.

Vedi anche

EnumResourceLanguagesA

EnumResourceLanguagesExA

IS_INTRESOURCE

MAKELANGID

Risorse

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione libloaderapi.h (includere Windows.h)