Compartilhar via


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

Uma função de retorno de chamada definida pelo aplicativo usada com as funções EnumResourceLanguagesW e EnumResourceLanguagesExW . 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_     LPCWSTR  lpszType,
  _In_     LPCWSTR  lpszName,
  _In_     WORD     wIDLanguage,
  _In_     LONG_PTR lParam
);

Sintaxe

ENUMRESLANGPROCW Enumreslangprocw;

BOOL Enumreslangprocw(
  [in, optional] HMODULE hModule,
  [in]           LPCWSTR lpType,
  [in]           LPCWSTR 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: LPCWSTR

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: LPCWSTR

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 para o recurso para o qual o idioma está sendo enumerado. A função EnumResourceLanguagesW ou EnumResourceLanguagesExW fornece esse valor. Para obter uma lista dos identificadores de idioma primários e identificadores de sublanguagem que constituem um identificador de linguagem, consulte MAKELANGID.

[in] lParam

Tipo: LONG_PTR

O parâmetro definido pelo aplicativo passado para a função EnumResourceLanguagesW ou EnumResourceLanguagesExW . 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 EnumResourceLanguagesW ou EnumResourceLanguagesExW .

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

Confira também

EnumResourceLanguagesW

EnumResourceLanguagesExW

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)