Function Reference


_WinAPI_GetObjectInfoByHandle

Retrieves information about a specified object

#include <WinAPISys.au3>
_WinAPI_GetObjectInfoByHandle ( $hObject )

Parameters

$hObject A handle to the object to obtain information about.

Return Value

Success: The array containing the following information:
[0] - The attributes of the object.
[1] - A mask that represents the granted access to the object.
[2] - The number of handles to the object.
[3] - The number of pointers to the object.
Failure: Sets the @error flag to non-zero, @extended flag may contain the NTSTATUS error code.

See Also

Search ZwQueryObject in MSDN Library.

Example

#include <WinAPISys.au3>

Local $sFile = @ScriptFullPath
Local $hFile = _WinAPI_CreateFile($sFile, 2, 0, 6)
If @error Then Exit

Local $aInfo = _WinAPI_GetObjectInfoByHandle($hFile)
If IsArray($aInfo) Then
    ConsoleWrite('File:       ' & $sFile & @CRLF)
    ConsoleWrite('Handle:     ' & $hFile & @CRLF)
    ConsoleWrite('Attributes: 0x' & Hex($aInfo[0]) & @CRLF)
    ConsoleWrite('Access:     0x' & Hex($aInfo[1]) & @CRLF)
    ConsoleWrite('Handles:    ' & $aInfo[2] & @CRLF)
    ConsoleWrite('Pointers:   ' & $aInfo[3] & @CRLF)
EndIf

_WinAPI_CloseHandle($hFile)