SetUserObjectInformationA-Funktion (winuser.h)

Artikel
11/20/2024

Legt Informationen über die angegebene Fensterstation oder das Desktopobjekt fest.

Syntax

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

Parameter

[in] hObj

Ein Handle für die Fensterstation, das Desktopobjekt oder ein aktueller Prozess-Pseudohandle. Dieser Handle kann von der CreateWindowStation, OpenWindowStation, CreateDesktop-, OpenDesktop- oder GetCurrentProcess-Funktion zurückgegeben werden.

[in] nIndex

Die festzulegenden Objektinformationen. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
UOI_FLAGS 1	Legt die Handle-Flags des Objekts fest. Der pvInfo Parameter muss auf eine USEROBJECTFLAGS- Struktur verweisen.
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	Legt das Ausnahmebehandlungsverhalten beim Aufrufen TimerProc-fest. hObj- muss der Prozesshandle sein, der von der GetCurrentProcess--Funktion zurückgegeben wird. Der pvInfo Parameter muss auf einen BOOL verweisen. Wenn TRUE, schließt Windows seine Aufrufe an TimerProc- mit einem Ausnahmehandler ein, der alle Ausnahmen verwendet und verwirft. Dies ist das Standardverhalten seit Windows 2000, obwohl sich dies in zukünftigen Versionen von Windows ändern kann. Wenn pvInfo- auf FALSE verweist, schließt Windows seine Aufrufe an TimerProc- nicht mit einem Ausnahmehandler ein. Es wird eine Einstellung von FALSE empfohlen. Andernfalls könnte sich die Anwendung unvorhersehbar verhalten und anfälliger für Sicherheits exploits sein.

Wert

Bedeutung

UOI_FLAGS
1

Legt die Handle-Flags des Objekts fest. Der pvInfo Parameter muss auf eine USEROBJECTFLAGS- Struktur verweisen.

UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7

Legt das Ausnahmebehandlungsverhalten beim Aufrufen TimerProc-fest. hObj- muss der Prozesshandle sein, der von der GetCurrentProcess--Funktion zurückgegeben wird.

Der pvInfo Parameter muss auf einen BOOL verweisen. Wenn TRUE, schließt Windows seine Aufrufe an TimerProc- mit einem Ausnahmehandler ein, der alle Ausnahmen verwendet und verwirft. Dies ist das Standardverhalten seit Windows 2000, obwohl sich dies in zukünftigen Versionen von Windows ändern kann.

Wenn pvInfo- auf FALSE verweist, schließt Windows seine Aufrufe an TimerProc- nicht mit einem Ausnahmehandler ein. Es wird eine Einstellung von FALSE empfohlen. Andernfalls könnte sich die Anwendung unvorhersehbar verhalten und anfälliger für Sicherheits exploits sein.

[in] pvInfo

Ein Zeiger auf einen Puffer, der die Objektinformationen oder einen BOOL enthält.

[in] nLength

Die Größe der im Puffer enthaltenen Informationen, auf die pvInfo-in Byte verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der winuser.h-Header definiert SetUserObjectInformation als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll