Função SetUserObjectInformationW (winuser.h)

Artigo
11/20/2024

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

Sintaxe

BOOL SetUserObjectInformationW(
  [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 pelo CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop ou função 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 de 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 de 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 de retorno

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

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

Observações

Nota

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

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

estação de janela e funções da área de trabalho

Compartilhar via