Microsoft DirectX 8.1 (C++)

ICAPolicy::get_OkToPersist

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

The get_OkToPersist method determines whether the Conditional Access (CA) Manager should store this policy.

Syntax

HRESULT get_OkToPersist(
  BOOL*  pfOkToPersist
);

Parameters

  pfOkToPersist

[out]  Pointer to a variable that receives a Boolean value. If the value is TRUE, the policy can be stored. If the value is FALSE, the policy cannot be stored.

Return Values

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

Remarks

A policy can be either dynamic or persistent. Typically, software policies are persistent, and DirectShow filter policies are dynamic.

A persistent policy should return TRUE in the pfOkToPersist parameter. Also, it must implement one of the following standard persistence interfaces: IPersistStream, IPersistStorage, or IPersistPropertyBag.

A dynamic policy should return FALSE in the pfOkToPersist parameter.

See Also