Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The ICADenial object represents a denial. Policies create denials in order to block access to another object. A denial can be associated either with a request or with a component. When a request has a denial, the user cannot access any part of the requested service. When a component has a denial, the user cannot access that particular component.
Denials typically have tolls, which the user can pay and thereby remove the denial. Depending on the implementation, this could require a complex credit card transaction, or something as simple as entering a password. It is possible for a denial to have no tolls, in which case the user cannot remove the denial.
Tolls, in turn, can have their own denials. If a toll has a denial, the toll is disabled and the user cannot pay it. Typically the denial will have another toll. Payment of that toll enables the first toll.
If a denial has several tolls, the user can remove the denial by paying any of the tolls. If a denial does not have any tolls, the user cannot remove the denial. (This is called an absolute denial.)
Every denial is managed by a particular policy. The denial cannot be removed unless that policy’s ICAPolicy.OkToRemoveDenial property is TRUE.
Property | Description |
DeniedObject | Returns the object that this denial is blocking. |
Description | Sets or returns a description of the denial. |
Policy | Returns the policy that imposed this denial. |
State | Sets or returns the state of the denial. |
Tolls | Returns the tolls that apply to this denial. |
Method | Description |
NotifyTollStateChanged | Signals that the state of a toll has changed. |