Função EnumPropsA (winuser.h)

Artigo
03/13/2024

Enumera todas as entradas na lista de propriedades de uma janela passando-as, uma por uma, para a função de retorno de chamada especificada. EnumProps continua até que a última entrada seja enumerada ou a função de retorno de chamada retorne FALSE.

Para passar dados definidos pelo aplicativo para a função de retorno de chamada, use a função EnumPropsEx .

Sintaxe

int EnumPropsA(
  [in] HWND          hWnd,
  [in] PROPENUMPROCA lpEnumFunc
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela cuja lista de propriedades deve ser enumerada.

[in] lpEnumFunc

Tipo: PROPENUMPROC

Um ponteiro para a função de retorno de chamada. Para obter mais informações sobre a função de retorno de chamada, consulte a função PropEnumProc .

Retornar valor

Tipo: int

O valor retornado especifica o último valor retornado pela função de retorno de chamada. Será -1 se a função não encontrar uma propriedade para enumeração.

Comentários

Um aplicativo pode remover apenas as propriedades que adicionou. Ele não deve remover as propriedades adicionadas por outros aplicativos ou pelo próprio sistema.

Observação

O cabeçalho winuser.h define EnumProps 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

Requisito	Valor
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)
Biblioteca	User32.lib
DLL	User32.dll