Edit

OB_PRE_DUPLICATE_HANDLE_INFORMATION structure (wdm.h)

  • Article

The OB_PRE_DUPLICATE_HANDLE_INFORMATION structure provides information to an ObjectPreCallback routine about a thread or process handle that is being duplicated.

Syntax

typedef struct _OB_PRE_DUPLICATE_HANDLE_INFORMATION {
  ACCESS_MASK DesiredAccess;
  ACCESS_MASK OriginalDesiredAccess;
  PVOID       SourceProcess;
  PVOID       TargetProcess;
} OB_PRE_DUPLICATE_HANDLE_INFORMATION, *POB_PRE_DUPLICATE_HANDLE_INFORMATION;

Members

DesiredAccess

An ACCESS_MASK value that specifies the access rights to grant for the handle. By default, this member equals OriginalDesiredAccess, but the ObjectPreCallback routine can modify this value to restrict the access that is granted. For a description of the access rights that drivers can use, see OB_PRE_CREATE_HANDLE_INFORMATION.

OriginalDesiredAccess

An ACCESS_MASK value that specifies the original access that was requested for the handle.

SourceProcess

A pointer to the process object for the process that is the source of the handle.

TargetProcess

A pointer to the process object for the process that receives the duplicated handle.

Remarks

You can never add access rights beyond what is specified in the DesiredAccess member. If the access right is listed as a modifiable flag, the access right can be removed.

Requirements

Requirement Value
Minimum supported client Available in Windows Server 2008 and later versions of the Windows operating system.
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

ACCESS_MASK

ObjectPreCallback