ICAPolicy::put_CAManager

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

The put_CAManager method specifies the Conditional Access (CA) Manager.

Syntax

HRESULT put_CAManager(
  ICAManager*  pManager
);

Parameters

  pManager

[in]  Pointer to the ICAManager interface of the CA Manager, or NULL.

Return Values

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

Remarks

This method sets the policy object’s pointer to the CA Manager. Whenever a policy is added to the ICAPolicies collection, or is loaded from storage, the collection calls this method with a valid ICAManager pointer. When the policy is removed, the method is called with a NULL pointer. This is guaranteed to occur before the CA Manager is deleted.

If pManager is non-NULL, the policy should store the pointer and call IUnknown::AddRef. If pManager is NULL, the policy should release all references to the CA Manager.

Note    Setting pManager to NULL does not remove the policy from the CA Manager’s policy collection.

The method should fail if pManager is non-NULL and the policy already has an ICAManager pointer.

See Also

• ICAPolicy Interface