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