Função de retorno de chamada PROPENUMPROCEXA (winuser.h)

Artigo
03/15/2023

Função de retorno de chamada definida pelo aplicativo usada com a função EnumPropsEx . A função recebe entradas de propriedade da lista de propriedades de uma janela. O tipo PROPENUMPROCEX define um ponteiro para essa função de retorno de chamada. PropEnumProcEx é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Parâmetros

unnamedParam1

Digite: HWND

Um identificador para a janela cuja lista de propriedades está sendo enumerada.

unnamedParam2

Tipo: LPTSTR

O componente de cadeia de caracteres de uma entrada de lista de propriedades. Essa é a cadeia de caracteres especificada, juntamente com um identificador de dados, quando a propriedade foi adicionada à lista de propriedades da janela por meio de uma chamada para a função SetProp .

unnamedParam3

Tipo: HANDLE

Um identificador para os dados. Esse identificador é o componente de dados de uma entrada de lista de propriedades.

unnamedParam4

Tipo: ULONG_PTR

Dados definidos pelo aplicativo. Esse é o valor especificado como o parâmetro lParam da chamada para EnumPropsEx que iniciou a enumeração.

Valor retornado

Tipo: BOOL

Retornar TRUE para continuar a enumeração da lista de propriedades.

Retornar FALSE para interromper a enumeração da lista de propriedades.

Comentários

As seguintes restrições se aplicam a essa função de retorno de chamada:

A função de retorno de chamada pode chamar a função RemoveProp . No entanto, RemoveProp pode remover apenas a propriedade passada para a função de retorno de chamada por meio dos parâmetros da função de retorno de chamada.
A função de retorno de chamada não deve tentar adicionar propriedades.

Observação

O cabeçalho winuser.h define PROPENUMPROCEX 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	winuser.h (inclua Windows.h)