Microsoft DirectX 8.1 (C++)

ICAPolicy.OkToRemove

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

The OkToRemove property determines whether the policy can be removed.

Syntax

objCAPolicy.OkToRemove As Long

Parameters

This property does not take any parameters.

Error Codes

If the property fails, an error is raised and Err.Number is set to a value other than zero.

Return Values

Returns a Boolean value. If the value is TRUE, the policy can be removed. Otherwise, it cannot.

Remarks

The ICAPolicies.Remove method checks this property to confirm that it has permission to remove the policy. A software policy should always return the value FALSE. A DirectShow filter policy is responsible for removing itself before the filter leaves the graph. Therefore, a filter policy should return FALSE until the filter is ready to remove itself. At that point, it should return TRUE.

This property is read-only.

See Also