Função SetUserObjectInformationA (winuser.h)

Artigo
08/28/2023

Define informações sobre a estação de janela especificada ou o objeto de área de trabalho.

Sintaxe

BOOL SetUserObjectInformationA(
  [in] HANDLE hObj,
  [in] int    nIndex,
  [in] PVOID  pvInfo,
  [in] DWORD  nLength
);

Parâmetros

[in] hObj

Um identificador para a estação de janela, o objeto da área de trabalho ou um pseudo-identificador de processo atual. Esse identificador pode ser retornado pela função CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop ou GetCurrentProcess .

[in] nIndex

As informações do objeto a serem definidas. Esse parâmetro pode ser o valor a seguir.

Valor	Significado
UOI_FLAGS 1	Define os sinalizadores de identificador do objeto. O parâmetro pvInfo deve apontar para uma estrutura USEROBJECTFLAGS .
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	Define o comportamento de tratamento de exceção ao chamar TimerProc. hObj deve ser o identificador de processo retornado pela função GetCurrentProcess . O parâmetro pvInfo deve apontar para um BOOL. Se TRUE, o Windows colocará suas chamadas para TimerProc com um manipulador de exceção que consome e descarta todas as exceções. Esse tem sido o comportamento padrão desde o Windows 2000, embora isso possa mudar em versões futuras do Windows. Se pvInfo apontar para FALSE, o Windows não colocará suas chamadas para TimerProc com um manipulador de exceção. Uma configuração de FALSE é recomendada. Caso contrário, o aplicativo poderia se comportar de forma imprevisível e poderia ser mais vulnerável a explorações de segurança.

Valor

Significado

UOI_FLAGS
1

Define os sinalizadores de identificador do objeto. O parâmetro pvInfo deve apontar para uma estrutura USEROBJECTFLAGS .

UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7

Define o comportamento de tratamento de exceção ao chamar TimerProc. hObj deve ser o identificador de processo retornado pela função GetCurrentProcess .

O parâmetro pvInfo deve apontar para um BOOL. Se TRUE, o Windows colocará suas chamadas para TimerProc com um manipulador de exceção que consome e descarta todas as exceções. Esse tem sido o comportamento padrão desde o Windows 2000, embora isso possa mudar em versões futuras do Windows.

Se pvInfo apontar para FALSE, o Windows não colocará suas chamadas para TimerProc com um manipulador de exceção. Uma configuração de FALSE é recomendada. Caso contrário, o aplicativo poderia se comportar de forma imprevisível e poderia ser mais vulnerável a explorações de segurança.

[in] pvInfo

Um ponteiro para um buffer que contém as informações do objeto ou um BOOL.

[in] nLength

O tamanho das informações contidas no buffer apontado por pvInfo, em bytes.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Observação

O cabeçalho winuser.h define SetUserObjectInformation 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. 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)
Biblioteca	User32.lib
DLL	User32.dll