Função EnumResourceNamesExW (libloaderapi.h)
Enumera recursos de um tipo especificado associado a um módulo binário especificado. A pesquisa pode incluir um arquivo LN e seus arquivos .mui associados ou pode ser limitado de várias maneiras.
Sintaxe
BOOL EnumResourceNamesExW(
[in, optional] HMODULE hModule,
LPCWSTR lpType,
[in] ENUMRESNAMEPROCW lpEnumFunc,
[in] LONG_PTR lParam,
[in] DWORD dwFlags,
[in] LANGID LangId
);
Parâmetros
[in, optional] hModule
Tipo: HMODULE
O identificador de um módulo a ser pesquisado. Normalmente, esse é um arquivo LN e, se o sinalizador RESOURCE_ENUM_MUI estiver definido, os arquivos .mui apropriados serão incluídos na pesquisa. Como alternativa, isso pode ser um identificador para um arquivo .mui ou outro arquivo LN.
Se esse parâmetro for NULL, será equivalente a passar um identificador para o módulo usado para criar o processo atual.
lpType
Tipo: LPCTSTR
O tipo do recurso para o qual o nome está sendo enumerado. Como alternativa, em vez de um ponteiro, esse parâmetro pode ser MAKEINTRESOURCE (ID), em que a ID é um valor inteiro que representa um tipo de recurso predefinido. Para obter uma lista de tipos de recursos predefinidos, consulte tipos de recursos. Para obter mais informações, consulte a seção Comentários abaixo.
[in] lpEnumFunc
Tipo: ENUMRESNAMEPROC
Um ponteiro para a função de retorno de chamada a ser chamada para cada nome de recurso enumerado. Para obter mais informações, consulte EnumResNameProc.
[in] lParam
Tipo: LONG_PTR
Um valor definido pelo aplicativo passado para a função de retorno de chamada. Esse parâmetro pode ser usado na verificação de erros.
[in] dwFlags
Tipo: DWORD
O tipo de arquivo a ser pesquisado. Há suporte para os valores a seguir. Observe que, se dwFlags for zero, os sinalizadores RESOURCE_ENUM_LN e RESOURCE_ENUM_MUI serão considerados especificados.
[in] LangId
Tipo: LANGID
O idioma de localização usado para filtrar a pesquisa no módulo MUI. Esse parâmetro é usado somente quando o sinalizador de RESOURCE_ENUM_MUI é definido em dwFlags. Se zero for especificado, todos os arquivos .mui que correspondem às preferências de idioma atuais serão incluídos na pesquisa, seguindo a estratégia usual do Carregador de Recursos (consulte Gerenciamento de Linguagem de Interface do Usuário). Se um
Valor de retorno
Tipo: BOOL
A função VERDADEIRO se tiver êxito ou FALSE se a função não encontrar um recurso do tipo especificado ou se a função falhar por outro motivo. Para obter informações de erro estendidas, chame GetLastError.
Observações
Se IS_INTRESOURCE(lpszType) for TRUE, lpszType especifica o identificador inteiro do tipo de recurso fornecido. Caso contrário, ele será 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.
A pesquisa de enumeração pode incluir um arquivo LN e seus arquivos .mui associados. Ele pode ser limitado a um único módulo binário de qualquer tipo. Ele também pode ser limitado aos arquivos .mui associados a um único arquivo LN. Ao especificar um arquivo LN para o parâmetro
Para cada recurso encontrado, EnumResourceNamesEx chama uma função de retorno de chamada definida pelo aplicativo lpEnumFunc, passando o nome ou a ID de cada recurso encontrado, bem como os vários outros parâmetros que foram passados para EnumResourceNamesEx.
Se um recurso tiver uma ID, a ID será retornada para a função de retorno de chamada; caso contrário, o nome do recurso é retornado para a função de retorno de chamada. Para obter mais informações, consulte EnumResNameProc.
A função EnumResourceNamesEx
Se hModule especificar um arquivo LN e ambos os sinalizadores forem selecionados, os nomes enumerados corresponderão aos recursos que residem nesse arquivo LN ou nos arquivos .mui associados a ele. Se nenhum arquivo .mui for encontrado, somente os nomes do arquivo LN serão retornados. Depois que um arquivo .mui apropriado for encontrado, a pesquisa não continuará mais, pois todos os arquivos .mui correspondentes a um único arquivo LN têm os mesmos nomes de recursos.
Se dwFlags e LangId forem zero, a função se comportará como EnumResourceNames.
Se LangId não for zero, somente o arquivo .mui correspondente a esse identificador de linguagem será pesquisado. Os fallbacks de linguagem não serão usados. Se um arquivo .mui para esse idioma não existir, a enumeração estará vazia (a menos que existam recursos para esse idioma no arquivo LN e o sinalizador esteja definido para pesquisar o arquivo LN também).
A enumeração nunca inclui duplicatas: se os recursos para um idioma específico estiverem contidos no arquivo LN e em um arquivo .mui, o nome será enumerado apenas uma vez.
Exemplos
Para obter um exemplo, consulte Criando uma lista de recursos.
Nota
O cabeçalho libloaderapi.h define EnumResourceNamesEx 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 Vista [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2008 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | libloaderapi.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |
Consulte também
Conceitual
EnumResNameProc
de referência de