ICARequest::get_ResolveDenials

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

The get_ResolveDenials method attempts to resolve the denials associated with this request.

Syntax

HRESULT get_ResolveDenials(
  long*  pcDenials
);

Parameters

  pcDenials

[out]  Pointer to a variable that receives the number of denials that remain unresolved, including denials on components.

Return Values

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

Remarks

This method performs the following steps:

• If ICAManager::get_UseDefaultUI returns 1, the method presents a default user interface (UI) for resolving denials. The default UI enables the user to select tolls for payment. If get_UseDefaultUI returns 0, the method skips directly to the next step.
• The method loops through the request’s denial collection, plus the denial collection of each component in the request.
• For each denial, the method loops through all the tolls that the user has selected.
• If a selected toll has denials, the method recursively calls get_ResolveDenials on it. The recursive call might (but might not) remove the denials.
• For every toll with no denials, the method calls the ICAToll::PayToll method. The PayToll method might display another UI, depending on the implementation of that toll. If the PayToll method succeeds, the toll removes the denial.

This method provides some minimal default functionality for resolving denials. It is expected that most applications will not call this method, and will provide their own implementation for this functionality. To do so, the application should respond to _ICAManagerEvents::RequestDenialAdded events.

See Also

• ICARequest Interface