Função EnumResourceTypesW (winbase.h)
Enumera tipos de recursos em um módulo binário. A partir do Windows Vista, isso normalmente é um executável portátil neutro em linguagem (arquivo LN) e a enumeração também inclui recursos de um dos arquivos de recurso específicos do idioma correspondente (arquivos .mui)— se houver— que contêm recursos de linguagem localizáveis. Também é possível usar hModule para especificar um arquivo .mui, nesse caso, somente esse arquivo é pesquisado para tipos de recursos.
Como alternativa, os aplicativos podem chamar EnumResourceTypesEx, que fornece controle mais preciso sobre quais arquivos de recurso enumerar.
Sintaxe
BOOL EnumResourceTypesW(
[in, optional] HMODULE hModule,
[in] ENUMRESTYPEPROCW lpEnumFunc,
[in] LONG_PTR lParam
);
Parâmetros
[in, optional] hModule
Tipo: HMODULE
Um identificador para um módulo a ser pesquisado. Esse identificador deve ser obtido por meio de loadlibrary ou LoadLibraryEx.
Consulte Comentários para obter mais informações.
Se esse parâmetro for NULL, isso equivale a passar um identificador para o módulo usado para criar o processo atual.
[in] lpEnumFunc
Tipo: ENUMRESTYPEPROC
Um ponteiro para a função de retorno de chamada a ser chamada para cada tipo de recurso enumerado. Para obter mais informações, consulte a função EnumResTypeProc
[in] lParam
Tipo: LONG_PTR
Um valor definido pelo aplicativo passado para a função de retorno de chamada.
Valor de retorno
Tipo: BOOL
Retorna verdadeiro se bem-sucedido; caso contrário, FALSE . Para obter informações de erro estendidas, chame GetLastError.
Observações
Para cada tipo de recurso encontrado, EnumResourceTypes chama uma função de retorno de chamada definida pelo aplicativo lpEnumFunc, passando cada tipo de recurso encontrado, bem como os vários outros parâmetros que foram passados para EnumResourceTypes.
EnumResourceTypes continua enumerar tipos de recursos até que a função de retorno de chamada retorne FALSE ou todos os tipos de recursos tenham sido enumerados.
A partir do Windows Vista, se hModule especificar um arquivo LN, os tipos enumerados corresponderão aos recursos que residem no arquivo LN e no arquivo .mui associado a ele. Se nenhum arquivo .mui for encontrado, somente os tipos do arquivo LN serão retornados. A ordem na qual os arquivos .mui são pesquisados é a ordem de pesquisa usual do Carregador de Recursos; consulte de Gerenciamento de Linguagem da Interface do Usuário para obter detalhes. Depois que um arquivo .mui apropriado for encontrado, a pesquisa não continuará mais para outros arquivos .mui associados ao arquivo LN, pois todos os arquivos .mui que correspondem a um único arquivo LN têm o mesmo conjunto de tipos de recursos.
A enumeração nunca inclui duplicatas: se um determinado tipo de recurso estiver contido no arquivo LN e em um arquivo .mui, o tipo será enumerado apenas uma vez.
Exemplos
Para obter um exemplo, consulte Criando uma lista de recursos.
Nota
O cabeçalho winbase.h define EnumResourceTypes como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |
Consulte também
Conceitual
de referência de