Microsoft DirectX 8.1 (C++)

ICARequest.Check

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The Check property queries all of the existing policies for denials.

Syntax

objCARequest.Check As Long

Parameters

This property does not take any parameters.

Error Codes

If the property fails, an error is raised and Err.Number is set to a value other than zero.

Return Values

Returns the total number of denials that were added.

Remarks

The Video Control retrieves this property when the user generates a new tune request. When this property is retrieved, the ICARequest object removes any existing denials from itself and from its components. Then it queries each policy by calling the ICAPolicy.CheckRequest method. If needed, the policies add denials, to the request or to components of the request.

Retrieving this property causes the CheckStarted and CheckComplete events to fire.

This property is read-only.

See Also