Microsoft DirectX 8.1 (C++)

ICADenials::get_AddNew

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

The get_AddNew method creates a new denial and adds it to the collection.

Syntax

HRESULT get_AddNew(
  ICAPolicy*  ppolicy,
  BSTR  bstrShortDesc,
  IUnknown*  pUnkDeniedObject,
  long  enDenialState,
  ICADenial**  ppDenial
);

Parameters

  ppolicy

[in]  Pointer to the ICAPolicy interface of the policy that imposes this denial.

  bstrShortDesc

[in]  String containing the short description of the denial.

  pUnkDeniedObject

[in]  Pointer to the IUnknown interface of the object that this denial will block.

  enDenialState

[in]  Member of the CADenialState enumeration, specifying the initial state of the denial. The value can be Denied or Transient.

  ppDenial

[out]  Pointer to a variable that receives the ICADenial interface of the denial.

Return Values

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

Remarks

If the method is successful, it triggers an _ICADenialsEvents::ItemAdded event.

After calling this method, the client should do the following:

See Also