| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The get_DenialsFor method retrieves an object's denial collection. In the current implementation, the object must be a toll and expose the ICAToll interface.
Syntax
HRESULT get_DenialsFor(
IUnknown* pUnk,
ICADenials** ppCADenials
);
Parameters
pUnk
[in] Pointer to the IUnknown interface of the object.
ppOffers
[out] Address of a variable that receives an ICADenials interface pointer.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
A toll must use this method to retrieve its own denials collection, because the ICADenials object cannot be created through CoCreateInstance. When the owning policy adds the toll to an ICATolls collection, the ICATolls collection automatically creates a denial collection for a toll.
The method fails if the toll does not yet belong to a collection of tolls. The policy must add the toll to a collection.
If the method succeeds, the ICADenials interface has an outstanding reference count. The caller must release the interface.
See Also