SetUserObjectInformationA, fonction (winuser.h)

Article
08/28/2023

Définit des informations sur la station de fenêtre ou l’objet de bureau spécifié.

Syntaxe

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

Paramètres

[in] hObj

Handle de la station de fenêtre, de l’objet de bureau ou d’un pseudo-handle de processus actuel. Ce handle peut être retourné par la fonction CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop ou GetCurrentProcess .

[in] nIndex

Informations sur l’objet à définir. Ce paramètre peut être la valeur suivante.

Valeur	Signification
UOI_FLAGS 1	Définit les indicateurs de handle de l’objet. Le paramètre pvInfo doit pointer vers une structure USEROBJECTFLAGS .
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	Définit le comportement de gestion des exceptions lors de l’appel de TimerProc. hObj doit être le handle de processus retourné par la fonction GetCurrentProcess . Le paramètre pvInfo doit pointer vers un BOOL. Si la valeur est TRUE, Windows entoure ses appels à TimerProc d’un gestionnaire d’exceptions qui consomme et ignore toutes les exceptions. Il s’agit du comportement par défaut depuis Windows 2000, bien que cela puisse changer dans les versions ultérieures de Windows. Si pvInfo pointe vers FALSE, Windows ne contient pas ses appels à TimerProc avec un gestionnaire d’exceptions. Un paramètre FALSE est recommandé. Sinon, l’application pourrait se comporter de manière imprévisible et pourrait être plus vulnérable aux attaques de sécurité.

Valeur

Signification

UOI_FLAGS
1

Définit les indicateurs de handle de l’objet. Le paramètre pvInfo doit pointer vers une structure USEROBJECTFLAGS .

UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7

Définit le comportement de gestion des exceptions lors de l’appel de TimerProc. hObj doit être le handle de processus retourné par la fonction GetCurrentProcess .

Le paramètre pvInfo doit pointer vers un BOOL. Si la valeur est TRUE, Windows entoure ses appels à TimerProc d’un gestionnaire d’exceptions qui consomme et ignore toutes les exceptions. Il s’agit du comportement par défaut depuis Windows 2000, bien que cela puisse changer dans les versions ultérieures de Windows.

Si pvInfo pointe vers FALSE, Windows ne contient pas ses appels à TimerProc avec un gestionnaire d’exceptions. Un paramètre FALSE est recommandé. Sinon, l’application pourrait se comporter de manière imprévisible et pourrait être plus vulnérable aux attaques de sécurité.

[in] pvInfo

Pointeur vers une mémoire tampon contenant les informations d’objet, ou un boOL.

[in] nLength

Taille des informations contenues dans la mémoire tampon pointée par pvInfo, en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

L’en-tête winuser.h définit SetUserObjectInformation en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll