GetHandleInformation-Funktion (handleapi.h)

  • Artikel

Ruft bestimmte Eigenschaften eines Objekthandles ab.

Syntax

BOOL GetHandleInformation(
  [in]  HANDLE  hObject,
  [out] LPDWORD lpdwFlags
);

Parameter

[in] hObject

Ein Handle für ein Objekt, dessen Informationen abgerufen 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.

[out] lpdwFlags

Ein Zeiger auf eine Variable, die eine Reihe von Bitflags empfängt, die Eigenschaften des Objekthandles oder 0 angeben. Die folgenden Werte werden definiert.

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.

Anforderungen

Anforderung Wert
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

Handle- und Objektfunktionen

SetHandleInformation