ACTRL_OVERLAPPED

[This is preliminary documentation and subject to change.]

The ACTRL_OVERLAPPED structure stores an event object and state information for an asynchronous access-control operation.

typedef struct _ACTRL_OVERLAPPED {
    ULONG       Reserved1;
    ULONG       Reserved2;
    HANDLE      hEvent;

} ACTRL_OVERLAPPED, *PACTRL_OVERLAPPED;
 

Members

Reserved1

Reserved for internal use.

Reserved2

Reserved for internal use.

hEvent

Handle to an event object. The SetSecurityInfoEx and SetNamedSecurityInfoEx functions create the event object and return this handle when they start an asynchronous operation. The system sets this event object to the signaled state when the operation is completed successfully or unsuccessfully.

Remarks

The first call to the GetOverlappedAccessResults function for a given ACTRL_OVERLAPPED structure closes the event object handle. Subsequent calls to GetOverlappedAccessResults use information stored in the reserved members to identify the asynchronous operation.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in accctrl.h.

See Also

Access Control Overview, Access Control Structures, GetOverlappedAccessResults, SetNamedSecurityInfoEx, SetSecurityInfoEx