CADenials.CountSelected

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

The CountSelected property retrieves the number of selected tolls.

Syntax

objCADenials.CountSelected As Long

Parameters

This property takes no 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 number of selected tolls. The sign of the returned value indicates whether the selected tolls are sufficient to remove all of the denials.

Remarks

When this property is retrieved, the object examines the denials in the collection; the tolls on those denials; and any denials that apply to those tolls, recursively.

The meaning of the return value depends on the sign:

• > 0: Every denial has at least one selected toll. The returned value is the number of selected tolls.
• 0: No tolls are selected.
• < 0: At least one toll is selected, but some denials have unselected tolls (or no tolls). The absolute value is the number of selected tolls.

If the value is positive, the user can pay the selected tolls and unblock the denied object. If the value is negative, the user has not selected enough tolls to unblock the object. Possibly one of the denials is absolute and has no tolls.

If the value is zero, the application should retrieve the CADenials.Count property to determine whether the collection contains any denials.

See Also

• CADenials Object