ICADenials::get_CountSelected

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

The get_CountSelected method retrieves the number of selected tolls.

Syntax

HRESULT get_CountSelected(
  long*  pCount
);

Parameters

  pCount

[out]  Pointer to a variable of type long that receives the number of selected tolls. The sign of the returned value indicates whether the selected tolls are sufficient to remove all of the denials. See Remarks for more information.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

This method examines the denials in the collection; the tolls on those denials; and any denials that apply to those tolls, recursively.

The meaning of the value returned in the Count parameter 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 call the ICADenials::get_Count method to check whether the collection contains any denials, or is empty.

See Also

• ICADenials Interface