CancelOverlappedAccess info  Overview  Group

[This is a preview of an interface that may appear in future releases of Windows.]

The CancelOverlappedAccess function cancels an asynchronous operation started by the SetSecurityInfoEx or SetNamedSecurityInfoEx functions.

DWORD CancelOverlappedAccess(

Parameters

pOverlapped

Pointer to the ACTRL_OVERLAPPED structure that was filled in by the SetSecurityInfoEx or SetNamedSecurityInfoEx call that started the asynchronous operation.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value can be one of the following error codes.

Remarks

If the CancelOverlappedAccess function is successful, the pOverlapped structure is no longer valid for GetOverlappedAccessResults or CancelOverlappedAccess calls.

The SetSecurityInfoEx or SetNamedSecurityInfoEx functions can start an asynchronous operation that sets the security on multiple objects, such as on a container object and the objects it contains. If such an operation is canceled, some of the objects might have the new security state while other objects remain in their original security state. In this case, an administrator must examine the objects to determine the appropriate action depending on their states.

Currently, the import library for the CancelOverlappedAccess function is ACCSRC.LIB. This is temporary. Eventually, the import library will be ADVAPI32.LIB. Meanwhile, any source code that links with the ACCSRC.LIB library must call the AccProvInit macro as follows:

    DWORD dwErrcode;



    AccProvInit(dwErrcode);

    if(dwErrcode != ERROR_SUCCESS)

    {

         // Consider this an error...

    }

 

See Also

ACTRL_OVERLAPPED, GetOverlappedAccessResults, SetSecurityInfoEx, SetNamedSecurityInfoEx

  .