Compartilhar via


Função EnumPropsA (winuser.h)

Enumera todas as entradas na lista de propriedades de uma janela passando-as, uma a uma, para a função de retorno de chamada especificada. de 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 função EnumPropsEx.

Sintaxe

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

Parâmetros

[in] hWnd

Tipo: 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.

Valor de retorno

Tipo: int

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

Observações

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.

Nota

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 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 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 winuser.h (inclua Windows.h)
biblioteca User32.lib
de DLL User32.dll

Consulte também

Conceitual

EnumPropsEx

propEnumProc

de referência de

Propriedades da janela