GetHandleInformation-Funktion (handleapi.h)
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 |
|---|---|
|
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.
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 |