SetHandleInformation-Funktion (handleapi.h)
Legt bestimmte Eigenschaften eines Objekthandles fest.
Syntax
BOOL SetHandleInformation(
[in] HANDLE hObject,
[in] DWORD dwMask,
[in] DWORD dwFlags
);
Parameter
[in] hObject
Ein Handle für ein Objekt, dessen Informationen festgelegt werden sollen.
Sie können ein Handle für einen der folgenden Objekttypen angeben: Zugriffstoken, Konsoleneingabepuffer, Konsolenbildschirmpuffer, Ereignis, Datei, Dateizuordnung, Auftrag, Maillot, Mutex, Pipe, Drucker, Prozess, Registrierungsschlüssel, Semaphor, serielles Kommunikationsgerät, Socket, Thread oder wartebarer Timer.
[in] dwMask
Eine Maske, die die zu ändernden Bitflags angibt. Verwenden Sie die gleichen Konstanten wie in der Beschreibung von dwFlags.
[in] dwFlags
Satz von Bitflags, die Eigenschaften des Objekthandles angibt. Dieser Parameter kann 0 oder ein oder mehrere der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Wenn dieses Flag festgelegt ist, erbt ein untergeordneter Prozess, der mit dem bInheritHandles-Parameter von CreateProcess erstellt wurde, der auf TRUE festgelegt ist, das Objekthandle. |
|
Wenn dieses Flag festgelegt ist, wird das Objekthandle durch Aufrufen der CloseHandle-Funktion nicht geschlossen. |
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Um das zugeordnete Bitflag in dwFlags festzulegen oder zu löschen, müssen Sie in dwMask ein Bitflag für die Änderungsmaske festlegen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | handleapi.h (Einschließen von Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |