Compartilhar via


Função de retorno de chamada ENUMRESLANGPROCA (libloaderapi.h)

Uma função de retorno de chamada definida pelo aplicativo usada com as funções EnumResourceLanguagesA e EnumResourceLanguagesExA . Ele recebe o tipo, o nome e o idioma de um item de recurso. O tipo ENUMRESLANGPROC define um ponteiro para essa função de retorno de chamada. EnumResLangProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

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

Sintaxe

ENUMRESLANGPROCA Enumreslangproca;

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

Parâmetros

[in, optional] hModule

Tipo: HMODULE

Um identificador para o módulo cujo arquivo executável contém os recursos para os quais os idiomas estão sendo enumerados. Se esse parâmetro for NULL, a função enumera as linguagens de recurso no módulo usado para criar o processo atual.

[in] lpType

Tipo: LPCSTR

O tipo de recurso para o qual o idioma está sendo enumerado. Como alternativa, em vez de um ponteiro, esse parâmetro pode ser MAKEINTRESOURCE(ID), em que ID é um valor inteiro que representa um tipo de recurso predefinido. Para tipos de recursos padrão, consulte Tipos de recursos. Para obter mais informações, consulte a seção Comentários abaixo.

[in] lpName

Tipo: LPCSTR

O nome do recurso para o qual o idioma está sendo enumerado. Como alternativa, em vez de um ponteiro, esse parâmetro pode ser MAKEINTRESOURCE(ID), em que ID é o identificador inteiro do recurso. Para obter mais informações, consulte a seção Comentários abaixo.

[in] wLanguage

Tipo: WORD

O identificador de idioma do recurso para o qual o idioma está sendo enumerado. A função EnumResourceLanguagesA ou EnumResourceLanguagesExA fornece esse valor. Para obter uma lista dos identificadores de idioma primários e identificadores de sublanguage que constituem um identificador de idioma, consulte MAKELANGID.

[in] lParam

Tipo: LONG_PTR

O parâmetro definido pelo aplicativo passado para a função EnumResourceLanguagesA ou EnumResourceLanguagesExA . Esse parâmetro pode ser usado na verificação de erros.

Retornar valor

Tipo: BOOL

Retorna TRUE para continuar a enumeração ou FALSE para interromper a enumeração.

Comentários

Se IS_INTRESOURCE(lpszType) for TRUE, lpszType especificará o identificador inteiro do tipo de recurso fornecido. Caso contrário, ele é um ponteiro para uma cadeia de caracteres terminada em nulo. Se o primeiro caractere da cadeia de caracteres for um sinal de libra (#), os caracteres restantes representarão um número decimal que especifica o identificador inteiro do tipo de recurso. Por exemplo, a cadeia de caracteres "#258" representa o identificador 258.

Da mesma forma, se IS_INTRESOURCE(lpszName) for TRUE, lpszName especificará o identificador inteiro do recurso especificado. Caso contrário, ele é um ponteiro para uma cadeia de caracteres terminada em nulo. Se o primeiro caractere da cadeia de caracteres for um sinal de libra (#), os caracteres restantes representarão um número decimal que especifica o identificador inteiro do recurso.

Um aplicativo deve registrar essa função passando seu endereço para a função EnumResourceLanguagesA ou EnumResourceLanguagesExA .

Se a função de retorno de chamada retornar FALSE, EnumResourceLanguagesA ou EnumResourceLanguagesExA interromperá a enumeração e retornará FALSE. O valor obtido de GetLastError será ERROR_RESOURCE_ENUM_USER_STOP.

Confira também

EnumResourceLanguagesA

EnumResourceLanguagesExA

IS_INTRESOURCE

MAKELANGID

Recursos

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho libloaderapi.h (inclua Windows.h)