IAccessControl::RevokeAccessRights method (iaccess.h)

Removes any explicit entries for the list of trustees.

Syntax

HRESULT RevokeAccessRights(
  [in] LPWSTR      lpProperty,
  [in] ULONG       cTrustees,
  [in] TRUSTEEW [] prgTrustees
);

Parameters

[in] lpProperty

The name of the property. If you are using the COM implementation of IAccessControl, this parameter must be NULL.

[in] cTrustees

The number of trustees in the list. This parameter cannot be 0.

[in] prgTrustees

A pointer to an array of trustee names. See TRUSTEE.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Even after removing explicit entries, the trustees might still have access entries due to group inclusion.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header iaccess.h

See also

IAccessControl