Función SetUserObjectInformationA (winuser.h)

Artículo
11/20/2024

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

Sintaxis

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

Parámetros

[in] hObj

Identificador de la estación de ventana, el objeto de escritorio o un pseudo handle de proceso actual. El CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop o función GetCurrentProcess.

[in] nIndex

Información del objeto que se va a establecer. Este parámetro puede ser el siguiente valor.

Valor	Significado
UOI_FLAGS 1	Establece las marcas de identificador del objeto. El parámetro pvInfo debe apuntar a una estructura USEROBJECTFLAGS de .
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	Establece el comportamiento de control de excepciones al llamar a TimerProc. hObj debe ser el identificador de proceso devuelto por la función getCurrentProcess . El parámetro pvInfo debe apuntar a una BOOL. Si es TRUE, Windows incluirá sus llamadas a TimerProc con un controlador de excepciones que consume y descarta todas las excepciones. Este ha sido el comportamiento predeterminado desde Windows 2000, aunque esto puede cambiar en versiones futuras de Windows. Si pvInfo apunta a FALSE, Windows no incluirá sus llamadas a TimerProc con un controlador de excepciones. Se recomienda una configuración de FALSE. De lo contrario, la aplicación podría comportarse de forma imprevisible y podría ser más vulnerable a las vulnerabilidades de seguridad.

Valor

Significado

UOI_FLAGS
1

Establece las marcas de identificador del objeto. El parámetro pvInfo debe apuntar a una estructura USEROBJECTFLAGS de .

UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7

Establece el comportamiento de control de excepciones al llamar a TimerProc. hObj debe ser el identificador de proceso devuelto por la función getCurrentProcess .

El parámetro pvInfo debe apuntar a una BOOL. Si es TRUE, Windows incluirá sus llamadas a TimerProc con un controlador de excepciones que consume y descarta todas las excepciones. Este ha sido el comportamiento predeterminado desde Windows 2000, aunque esto puede cambiar en versiones futuras de Windows.

Si pvInfo apunta a FALSE, Windows no incluirá sus llamadas a TimerProc con un controlador de excepciones. Se recomienda una configuración de FALSE. De lo contrario, la aplicación podría comportarse de forma imprevisible y podría ser más vulnerable a las vulnerabilidades de seguridad.

[in] pvInfo

Puntero a un búfer que contiene la información del objeto o una BOOL.

[in] nLength

Tamaño de la información contenida en el búfer al que apunta pvInfo, en bytes.

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

Consulte también

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

funciones de escritorio y estación de ventanas

estaciones de ventana de

Compartir a través de