Skip to content

Latest commit

 

History

History
129 lines (98 loc) · 6.24 KB

ne-webservices-ws_policy_property_id.md

File metadata and controls

129 lines (98 loc) · 6.24 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NE:webservices.WS_POLICY_PROPERTY_ID
WS_POLICY_PROPERTY_ID (webservices.h)
Identifies each policy property and its associated value.
WS_POLICY_PROPERTY_ID
WS_POLICY_PROPERTY_ID enumeration [Web Services for Windows]
WS_POLICY_PROPERTY_MAX_ALTERNATIVES
WS_POLICY_PROPERTY_MAX_DEPTH
WS_POLICY_PROPERTY_MAX_EXTENSIONS
WS_POLICY_PROPERTY_STATE
webservices/WS_POLICY_PROPERTY_ID
webservices/WS_POLICY_PROPERTY_MAX_ALTERNATIVES
webservices/WS_POLICY_PROPERTY_MAX_DEPTH
webservices/WS_POLICY_PROPERTY_MAX_EXTENSIONS
webservices/WS_POLICY_PROPERTY_STATE
wsw.ws_policy_property_id
wsw\ws_policy_property_id.htm
wsw
503d39c0-7546-429d-b8e3-66e80c76b7c1
12/05/2018
WS_POLICY_PROPERTY_ID, WS_POLICY_PROPERTY_ID enumeration [Web Services for Windows], WS_POLICY_PROPERTY_MAX_ALTERNATIVES, WS_POLICY_PROPERTY_MAX_DEPTH, WS_POLICY_PROPERTY_MAX_EXTENSIONS, WS_POLICY_PROPERTY_STATE, webservices/WS_POLICY_PROPERTY_ID, webservices/WS_POLICY_PROPERTY_MAX_ALTERNATIVES, webservices/WS_POLICY_PROPERTY_MAX_DEPTH, webservices/WS_POLICY_PROPERTY_MAX_EXTENSIONS, webservices/WS_POLICY_PROPERTY_STATE, wsw.ws_policy_property_id
webservices.h
Windows
Windows 7 [desktop apps \| UWP apps]
Windows Server 2008 R2 [desktop apps \| UWP apps]
Windows
WS_POLICY_PROPERTY_ID
19H1
WS_POLICY_PROPERTY_ID
webservices/WS_POLICY_PROPERTY_ID
c++
APIRef
kbSyntax
HeaderDef
WebServices.h
WS_POLICY_PROPERTY_ID

WS_POLICY_PROPERTY_ID enumeration

-description

Identifies each policy property and its associated value.

-enum-fields

-field WS_POLICY_PROPERTY_STATE:1

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

The current state of the policy object.

-field WS_POLICY_PROPERTY_MAX_ALTERNATIVES:2

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.

-field WS_POLICY_PROPERTY_MAX_DEPTH:3

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.

-field WS_POLICY_PROPERTY_MAX_EXTENSIONS:4

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 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.