SetUserObjectInformationW, fonction (winuser.h)

Article
11/20/2024

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

Syntaxe

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

Paramètres

[in] hObj

Handle vers la station de fenêtre, l’objet de bureau ou un pseudo-handle de processus actuel. Ce handle peut être retourné par leCreateWindowStation , OpenWindowStation, CreateDesktop, OpenDesktop ou Fonction 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 place ses appels à TimerProc avec 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 futures versions de Windows. Si pvInfo pointe vers FALSE, Windows ne place pas ses appels à TimerProc avec un gestionnaire d’exceptions. Un paramètre false est recommandé. Sinon, l’application peut se comporter de manière imprévisible et peut ê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 place ses appels à TimerProc avec 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 futures versions de Windows.

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

[in] pvInfo

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

[in] nLength

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

Valeur de retour

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

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Note

L’en-tête winuser.h définit SetUserObjectInformation comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll