Função de retorno de chamada ENUMRESTYPEPROCW (libloaderapi.h)
Uma função de retorno de chamada definida pelo aplicativo usada com as funções EnumResourceTypes
Sintaxe
ENUMRESTYPEPROCW Enumrestypeprocw;
BOOL Enumrestypeprocw(
[in, optional] HMODULE hModule,
LPWSTR lpType,
[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 tipos devem ser enumerados. Se esse parâmetro for NULL, a função enumera os tipos de recurso no módulo usado para criar o processo atual.
lpType
Tipo: LPTSTR
O tipo de recurso para o qual o tipo está sendo enumerado.
Como alternativa, em vez de um ponteiro, esse parâmetro pode ser (ID) MAKEINTRESOURCE, em que a ID é o identificador inteiro do tipo de recurso fornecido. Para tipos de recursos padrão, consulte Tipos de Recursos. Para obter mais informações, consulte a seção Comentários abaixo.
[in] lParam
Tipo: LONG_PTR
Um parâmetro definido pelo aplicativo passado para a função EnumResourceTypes ou EnumResourceTypesEx. Esse parâmetro pode ser usado na verificação de erros.
Valor de retorno
Tipo: BOOL
Retorna TRUE para continuar a enumeração ou FALSE para interromper a enumeração.
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.
Um aplicativo deve registrar essa função passando seu endereço para a função EnumResourceTypes ou EnumResourceTypesEx.
Se a função de retorno de chamada retornar FALSE, EnumResourceTypes ou EnumResourceTypesEx interromperá a enumeração e retornará false. No Windows XP e anteriores, o valor obtido de GetLastError será ERROR_SUCCESS; começando com o Windows Vista, o último valor de erro será ERROR_RESOURCE_ENUM_USER_STOP.
Nota
O cabeçalho libloaderapi.h define ENUMRESTYPEPROC como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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 | libloaderapi.h (inclua Windows.h) |
Consulte também
Conceitual
de referência de