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

Artigo
08/24/2023

Uma função de retorno de chamada definida pelo aplicativo usada com as funções EnumResourceTypes e EnumResourceTypesEx . Ele recebe tipos de recursos. O tipo ENUMRESTYPEPROC define um ponteiro para essa função de retorno de chamada. EnumResTypeProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

ENUMRESTYPEPROCA Enumrestypeproca;

BOOL Enumrestypeproca(
  [in, optional] HMODULE hModule,
                 LPSTR 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 recursos 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 MAKEINTRESOURCE(ID), em que 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 retornado

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.

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; a partir do Windows Vista, o último valor de erro será ERROR_RESOURCE_ENUM_USER_STOP.

Observação

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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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)