Función GetUserObjectInformationA (winuser.h)

Artículo
11/20/2024

Recupera información sobre la estación de ventana o el objeto de escritorio especificados.

Sintaxis

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

Parámetros

[in] hObj

Identificador de la estación de ventana o del objeto de escritorio. Este identificador lo devuelve el CreateWindowStation, OpenWindowStation, CreateDesktopo función de OpenDesktop.

[in] nIndex

Información que se va a recuperar. El parámetro puede ser uno de los siguientes valores.

Valor	Significado
UOI_FLAGS 1	Marcas de identificador. El parámetro pvInfo debe apuntar a una estructura USEROBJECTFLAGS de .
UOI_HEAPSIZE 5	Tamaño del montón de escritorio, en KB, como un valor de ULONG. El parámetro hObj debe ser un identificador para un objeto de escritorio; de lo contrario, se produce un error en la función. Windows Server 2003 y Windows XP/2000: Este valor no se admite.
UOI_IO 6	TRUE si el parámetro hObj es un identificador del objeto de escritorio que recibe la entrada del usuario. FALSE de lo contrario. Windows Server 2003 y Windows XP/2000: Este valor no se admite.
UOI_NAME 2	Nombre del objeto, como una cadena.
UOI_TYPE 3	Nombre de tipo del objeto, como una cadena.
UOI_USER_SID 4	Estructura SID que identifica al usuario asociado actualmente al objeto especificado. Si no hay ningún usuario asociado al objeto, el valor devuelto en el búfer al que apunta lpnLengthNeeded es cero. Tenga en cuenta que siD es una estructura de longitud variable. Normalmente, realizará una llamada a getUserObjectInformation para determinar la longitud del SID antes de recuperar su valor.

[out, optional] pvInfo

Puntero a un búfer para recibir la información del objeto.

[in] nLength

Tamaño del búfer al que apunta el parámetro pvInfo, en bytes.

[out, optional] lpnLengthNeeded

Puntero a una variable que recibe el número de bytes necesarios para almacenar la información solicitada. Si el valor de esta variable es mayor que el valor del parámetro nLength cuando la función devuelve, la función devuelve FALSE y ninguna de las informaciones se copia en el búfer de pvInfo. Si el valor de la variable a la que apunta lpnLengthNeeded es menor o igual que el valor de nLength, se copia todo el bloque de información.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado winuser.h define GetUserObjectInformation como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll
conjunto de API de	ext-ms-win-ntuser-windowstation-ansi-l1-1-0 (introducido en Windows 10, versión 10.0.10240)