ホーム › Networking.WindowsWebServices › WS_POLICY_PROPERTY_ID

WS_POLICY_PROPERTY_ID

列挙型

基底型i4

メンバー 4

名前	10進	16進	説明
WS_POLICY_PROPERTY_STATE	1	0x1	このプロパティは WsGetPolicyProperty で使用します。型は WS_POLICY_STATE です。ポリシーオブジェクトの現在の状態です。
WS_POLICY_PROPERTY_MAX_ALTERNATIVES	2	0x2	このプロパティは、WS_METADATA_PROPERTY* パラメーターの一部として WS_METADATA_PROPERTY_POLICY_PROPERTIES を指定する際に、WsCreateMetadata で使用します。型は ULONG です。このプロパティは、指定した WS_POLICY オブジェクトで許可される代替候補 (alternative) の最大数を制御します。ポリシーの処理時に割り当てられるメモリ量と消費される CPU は、ポリシーの実際のサイズではなく、ポリシーに含まれる代替候補の数に比例します。小さなポリシーであっても、アサーションのさまざまな組み合わせが展開されることにより、多数の代替候補を含む場合があります。このプロパティに大きな値を設定すると、過度な処理やメモリ消費につながるおそれがあります。既定値は 32 です。
WS_POLICY_PROPERTY_MAX_DEPTH	3	0x3	このプロパティは、WS_METADATA_PROPERTY_POLICY_PROPERTIES を指定する際に WsCreateMetadata で使用します。型は ULONG です。このプロパティは、読み取られて処理されるポリシーの最大の深さを制御します。ポリシーの最大の深さとは、対象のポリシーおよびそれが参照するすべてのポリシーを考慮したときの、入れ子になったコンテナー要素 (Policy、All、ExactlyOne) の入れ子レベルの最大数として定義されます。処理されるポリシーの各レベルにつき、わずかなスタック領域が消費されます。この値に大きな値を設定すると、深く入れ子になったポリシーや循環参照を含むポリシーでスタックオーバーフローが発生するおそれがあります。既定値は 32 です。
WS_POLICY_PROPERTY_MAX_EXTENSIONS	4	0x4	このプロパティは、WS_METADATA_PROPERTY_POLICY_PROPERTIES を指定する際に WsCreateMetadata で使用します。型は ULONG です。このプロパティは、指定した WS_POLICY オブジェクトで許可されるポリシー拡張 (未知のアサーション) の最大数を制御します。ポリシー拡張は、WsMatchPolicyAlternative API を使用する際に、 WS_POLICY_CONSTRAINTS 構造体に WS_POLICY_EXTENSION 配列を指定することで取得できます。既定値は 8 です。ポリシーの処理時に割り当てられるメモリ量と消費される CPU は、ポリシーの実際のサイズではなく、ポリシーに含まれる代替候補の数に比例します。小さなポリシーであっても、アサーションのさまざまな組み合わせが展開されることにより、多数の代替候補を含む場合があります。このプロパティに大きな値を設定すると、過度な処理やメモリ消費につながるおそれがあります。

公式ドキュメント

各ポリシープロパティとそれに関連付けられた値を識別します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum WS_POLICY_PROPERTY_ID : int {
    WS_POLICY_PROPERTY_STATE = 1,
    WS_POLICY_PROPERTY_MAX_ALTERNATIVES = 2,
    WS_POLICY_PROPERTY_MAX_DEPTH = 3,
    WS_POLICY_PROPERTY_MAX_EXTENSIONS = 4
} WS_POLICY_PROPERTY_ID;

public enum WS_POLICY_PROPERTY_ID : int
{
    WS_POLICY_PROPERTY_STATE = 1,
    WS_POLICY_PROPERTY_MAX_ALTERNATIVES = 2,
    WS_POLICY_PROPERTY_MAX_DEPTH = 3,
    WS_POLICY_PROPERTY_MAX_EXTENSIONS = 4,
}

Public Enum WS_POLICY_PROPERTY_ID As Integer
    WS_POLICY_PROPERTY_STATE = 1
    WS_POLICY_PROPERTY_MAX_ALTERNATIVES = 2
    WS_POLICY_PROPERTY_MAX_DEPTH = 3
    WS_POLICY_PROPERTY_MAX_EXTENSIONS = 4
End Enum

import enum

class WS_POLICY_PROPERTY_ID(enum.IntEnum):
    WS_POLICY_PROPERTY_STATE = 1
    WS_POLICY_PROPERTY_MAX_ALTERNATIVES = 2
    WS_POLICY_PROPERTY_MAX_DEPTH = 3
    WS_POLICY_PROPERTY_MAX_EXTENSIONS = 4

// WS_POLICY_PROPERTY_ID
pub const WS_POLICY_PROPERTY_STATE: i32 = 1;
pub const WS_POLICY_PROPERTY_MAX_ALTERNATIVES: i32 = 2;
pub const WS_POLICY_PROPERTY_MAX_DEPTH: i32 = 3;
pub const WS_POLICY_PROPERTY_MAX_EXTENSIONS: i32 = 4;

// WS_POLICY_PROPERTY_ID
const (
	WS_POLICY_PROPERTY_STATE int32 = 1
	WS_POLICY_PROPERTY_MAX_ALTERNATIVES int32 = 2
	WS_POLICY_PROPERTY_MAX_DEPTH int32 = 3
	WS_POLICY_PROPERTY_MAX_EXTENSIONS int32 = 4
)

const
  WS_POLICY_PROPERTY_STATE = 1;
  WS_POLICY_PROPERTY_MAX_ALTERNATIVES = 2;
  WS_POLICY_PROPERTY_MAX_DEPTH = 3;
  WS_POLICY_PROPERTY_MAX_EXTENSIONS = 4;

// WS_POLICY_PROPERTY_ID
pub const WS_POLICY_PROPERTY_STATE: i32 = 1;
pub const WS_POLICY_PROPERTY_MAX_ALTERNATIVES: i32 = 2;
pub const WS_POLICY_PROPERTY_MAX_DEPTH: i32 = 3;
pub const WS_POLICY_PROPERTY_MAX_EXTENSIONS: i32 = 4;

const
  WS_POLICY_PROPERTY_STATE* = 1
  WS_POLICY_PROPERTY_MAX_ALTERNATIVES* = 2
  WS_POLICY_PROPERTY_MAX_DEPTH* = 3
  WS_POLICY_PROPERTY_MAX_EXTENSIONS* = 4

enum WS_POLICY_PROPERTY_ID : int {
    WS_POLICY_PROPERTY_STATE = 1,
    WS_POLICY_PROPERTY_MAX_ALTERNATIVES = 2,
    WS_POLICY_PROPERTY_MAX_DEPTH = 3,
    WS_POLICY_PROPERTY_MAX_EXTENSIONS = 4,
}

#define global WS_POLICY_PROPERTY_STATE            0x1
#define global WS_POLICY_PROPERTY_MAX_ALTERNATIVES 0x2
#define global WS_POLICY_PROPERTY_MAX_DEPTH        0x3
#define global WS_POLICY_PROPERTY_MAX_EXTENSIONS   0x4