SetHandleInformation-Funktion (handleapi.h)

  • Artikel

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
HANDLE_FLAG_INHERIT
0x00000001
 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.
HANDLE_FLAG_PROTECT_FROM_CLOSE
0x00000002
 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

Siehe auch

CloseHandle

CreateProcess

GetHandleInformation

Handle- und Objektfunktionen