Função GetUserObjectInformationA (winuser.h)

Artigo
11/20/2024

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

Sintaxe

BOOL GetUserObjectInformationA(
  [in]            HANDLE  hObj,
  [in]            int     nIndex,
  [out, optional] PVOID   pvInfo,
  [in]            DWORD   nLength,
  [out, optional] LPDWORD lpnLengthNeeded
);

Parâmetros

[in] hObj

Um identificador para a estação de janela ou o objeto da área de trabalho. Esse identificador é retornado pela função CreateWindowStation, OpenWindowStation, CreateDesktopou OpenDesktop.

[in] nIndex

As informações a serem recuperadas. O parâmetro pode ser um dos seguintes valores.

Valor	Significado
UOI_FLAGS 1	Os sinalizadores de identificador. O parâmetro pvInfo deve apontar para uma estrutura de USEROBJECTFLAGS .
UOI_HEAPSIZE 5	O tamanho do heap da área de trabalho, em KB, como um valor de ULONG. O parâmetro hObj deve ser um identificador para um objeto de área de trabalho; caso contrário, a função falhará. Windows Server 2003 e Windows XP/2000: Não há suporte para esse valor.
UOI_IO 6	VERDADEIRO se o parâmetro hObj for um identificador para o objeto da área de trabalho que está recebendo entrada do usuário. false caso contrário. Windows Server 2003 e Windows XP/2000: Não há suporte para esse valor.
UOI_NAME 2	O nome do objeto, como uma cadeia de caracteres.
UOI_TYPE 3	O nome do tipo do objeto, como uma cadeia de caracteres.
UOI_USER_SID 4	O SID estrutura que identifica o usuário associado ao objeto especificado no momento. Se nenhum usuário estiver associado ao objeto, o valor retornado no buffer apontado por lpnLengthNeeded será zero. Observe que sid é uma estrutura de comprimento variável. Normalmente, você fará uma chamada para GetUserObjectInformation para determinar o comprimento do SID antes de recuperar seu valor.

[out, optional] pvInfo

Um ponteiro para um buffer para receber as informações do objeto.

[in] nLength

O tamanho do buffer apontado pelo parâmetro pvInfo, em bytes.

[out, optional] lpnLengthNeeded

Um ponteiro para uma variável que recebe o número de bytes necessários para armazenar as informações solicitadas. Se o valor dessa variável for maior que o valor do parâmetro nLength quando a função retornar, a função retornará FALSE e nenhuma das informações será copiada para o buffer pvInfo. Se o valor da variável apontado por lpnLengthNeeded for menor ou igual ao valor de nLength, todo o bloco de informações será copiado.

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 GetUserObjectInformation 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
conjunto de API	ext-ms-win-ntuser-windowstation-ansi-l1-1-0 (introduzido no Windows 10, versão 10.0.10240)

Consulte também

CreateDesktop

CreateWindowStation

GetUserObjectSecurity

OpenDesktop

OpenWindowStation

SID

SetUserObjectInformation

SetUserObjectSecurity

USEROBJECTFLAGS

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

Compartilhar via