Funzione SetUserObjectInformationW (winuser.h)

Articolo
03/13/2024

Imposta informazioni sulla stazione finestra o sull'oggetto desktop specificati.

Sintassi

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

Parametri

[in] hObj

Handle per la stazione finestra, l'oggetto desktop o un handle pseudo-processo corrente. Questo handle può essere restituito dalla funzione CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop o GetCurrentProcess.

[in] nIndex

Informazioni sull'oggetto da impostare. Questo parametro può essere il valore seguente.

Valore	Significato
UOI_FLAGS 1	Imposta i flag di handle dell'oggetto. Il parametro pvInfo deve puntare a una struttura USEROBJECTFLAGS .
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	Imposta il comportamento di gestione delle eccezioni quando si chiama TimerProc. hObj deve essere l'handle di processo restituito dalla funzione GetCurrentProcess . Il parametro pvInfo deve puntare a un valore BOOL. Se TRUE, Windows racchiuderà le chiamate a TimerProc con un gestore di eccezioni che utilizza ed elimina tutte le eccezioni. Questo è stato il comportamento predefinito da Windows 2000, anche se potrebbe cambiare nelle versioni future di Windows. Se pvInfo punta a FALSE, Windows non racchiuderà le chiamate a TimerProc con un gestore di eccezioni. È consigliata un'impostazione di FALSE. In caso contrario, l'applicazione potrebbe comportarsi imprevedibilmente e potrebbe essere più vulnerabile agli exploit di sicurezza.

Valore

Significato

UOI_FLAGS
1

Imposta i flag di handle dell'oggetto. Il parametro pvInfo deve puntare a una struttura USEROBJECTFLAGS .

UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7

Imposta il comportamento di gestione delle eccezioni quando si chiama TimerProc. hObj deve essere l'handle di processo restituito dalla funzione GetCurrentProcess .

Il parametro pvInfo deve puntare a un valore BOOL. Se TRUE, Windows racchiuderà le chiamate a TimerProc con un gestore di eccezioni che utilizza ed elimina tutte le eccezioni. Questo è stato il comportamento predefinito da Windows 2000, anche se potrebbe cambiare nelle versioni future di Windows.

Se pvInfo punta a FALSE, Windows non racchiuderà le chiamate a TimerProc con un gestore di eccezioni. È consigliata un'impostazione di FALSE. In caso contrario, l'applicazione potrebbe comportarsi imprevedibilmente e potrebbe essere più vulnerabile agli exploit di sicurezza.

[in] pvInfo

Puntatore a un buffer contenente le informazioni sull'oggetto o un valore BOOL.

[in] nLength

Dimensioni delle informazioni contenute nel buffer a cui fa riferimento pvInfo, in byte.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione winuser.h definisce SetUserObjectInformation come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll