CADenials.AddNew

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

The AddNew property creates a new denial and adds it to the collection.

Syntax

objCADenials.AddNew(
    objPolicy As ICAPolicy, 
    strShortDesc As String,
    ObjDeniedObject As Object,
    enDenialState As Long) As ICADenial

Parameters

  objPolicy

Specifies the ICAPolicy object that imposes this denial.

  strShortDesc

String containing the short description of the denial.

  objDeniedObject

Object that this denial will block.

  enDenialState

CADenialState constant, specifying the initial state of the denial. The value can be Denied or Transient.

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 new ICADenial object.

Remarks

Adding a denial to the collection triggers an ItemAdded event.

After adding a denial, the client should do the following:

• Add descriptions in the other formats. See ICADenial.Description.
• Add applicable tolls to the denial. See ICADenial.Tolls.

This property is read-only.

See Also

• CADenials Object