Expand Minimize

WS_POLICY_PROPERTY_ID enumeration

Identifies each policy property and its associated value.

Syntax


enum WS_POLICY_PROPERTY_ID {  WS_POLICY_PROPERTY_STATE, 
  WS_POLICY_PROPERTY_MAX_ALTERNATIVES, 
  WS_POLICY_PROPERTY_MAX_DEPTH, 
  WS_POLICY_PROPERTY_MAX_EXTENSIONS 

};

Constants

WS_POLICY_PROPERTY_STATE

This property is used with WsGetPolicyProperty. It is of type WS_POLICY_STATE.

The current state of the policy object.

WS_POLICY_PROPERTY_MAX_ALTERNATIVES

This property is used with WsCreateMetadata when specifying WS_METADATA_PROPERTY_POLICY_PROPERTIES as part of the WS_METADATA_PROPERTY* parameter. It is of type ULONG.

This property controls the maximum number of alternatives allowed for a given WS_POLICY object.

When a policy is processed, the amount of memory allocated and CPU consumed is proportional to the number of policy alternatives present in the policy, not to the actual size of the policy. Even a small policy may contain a large number of alternatives due to the expansion of different permutations of assertions. Setting this property to a large value may lead to excessive processing or memory consumption.

The default value is 32.

WS_POLICY_PROPERTY_MAX_DEPTH

This property is used with WsCreateMetadata when specifying WS_METADATA_PROPERTY_POLICY_PROPERTIES. It is of type ULONG.

This property controls the maximum depth of any policy that is read and processed. The maximum depth of a policy is defined as the maximum number of levels of nested container elements (Policy, All, ExactlyOne) when considering the policy and any policies that it references.

A small amount of stack space is consumed for each level of policy that is processed. Setting this value to a large value may lead to stack overflow for a policy that is deeply nested or contains a cyclic reference.

The default value is 32.

WS_POLICY_PROPERTY_MAX_EXTENSIONS

This property is used with WsCreateMetadata when specifying WS_METADATA_PROPERTY_POLICY_PROPERTIES. It is of type ULONG.

This property controls the maximum number of policy extensions (unknown assertions) allowed for a given WS_POLICY object. Policy extensions can be retrieved by supplying WS_POLICY_EXTENSION array in WS_POLICY_CONSTRAINTS structure when using the WsMatchPolicyAlternative API.

The default value is 8.

When a policy is processed, the amount of memory allocated and CPU consumed is porportional to the number of policy alternatives present in the policy, not to the actual size of the policy. Even a small policy may contain a large number of alternatives due to the expansion of different permutations of assertions. Setting this property to a large value may lead to excessive processing or memory consumption.

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

WebServices.h

 

 

Community Additions

ADD
Show:
© 2015 Microsoft