Win32 API 日本語リファレンス
ホーム › Networking.WindowsWebServices › WS_XML_READER_PROPERTY_ID

WS_XML_READER_PROPERTY_ID

列挙型
📘 Microsoft Learn (日本語) · English
基底型i4

メンバー 15

名前10進16進説明
WS_XML_READER_PROPERTY_MAX_DEPTH00x0

リーダーが許可するドキュメントの最大の深さを指定する ULONG です。

深さは、任意の時点でネストされている開始要素の数によって測定されます。

深さが 0 の場合、開始要素は一切読み取れません。

このプロパティの既定値は 32 です。

セキュリティに関する考慮事項については、WsCreateReader を参照してください。

WS_XML_READER_PROPERTY_ALLOW_FRAGMENT10x1

リーダーがドキュメントの最上位レベルで複数の要素および空白以外の文字を許可するかどうかを指定する BOOL です。このプロパティは、WS_XML_READER_MTOM_ENCODING と共に TRUE に設定することはできません。

このプロパティの既定値は FALSE です。

WS_XML_READER_PROPERTY_MAX_ATTRIBUTES20x2

リーダーが 1 つの要素に対して許可する属性の最大数を指定する ULONG です。

このプロパティの既定値は 128 です。

セキュリティに関する考慮事項については、WsCreateReader を参照してください。

WS_XML_READER_PROPERTY_READ_DECLARATION30x3

リーダーがドキュメントの先頭で xml 宣言を許可するかどうかを指定する BOOL です。

このプロパティの既定値は TRUE です。

WS_XML_READER_PROPERTY_CHARSET40x4

xml ドキュメントの文字セットを返す WS_CHARSET 値です。この値はテキストドキュメントでのみ使用できます。

リーダーが WS_CHARSET_AUTO で初期化された場合、リーダーはこの値を自動的に判別します。リーダーの入力ソースがストリーミングされる場合は、先頭のバイト順マークと xml 宣言を検査できるだけのデータがリーダーにバッファーされている必要があります。WsFillReader を参照してください。

リーダーがそれ以外の値で初期化された場合、このプロパティは単にその値を返します。

WS_XML_READER_PROPERTY_ROW50x5テキスト xml ドキュメントにおいて、リーダーが位置しているノードの 0 から始まる行番号を返す ULONGLONG です。
WS_XML_READER_PROPERTY_COLUMN60x6テキスト xml ドキュメントにおいて、リーダーが位置しているノードの 0 から始まる列番号を返す ULONGLONG です。
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE70x7

WS_XML_READER が UTF-16 から UTF-8 への変換を行うために使用する内部バッファーのトリムサイズを指定する ULONG です。この値を大きくするとメモリの使用量は増えますが、UTF-16 でエンコードされたドキュメントを処理する際の割り当てを削減できます。

このプロパティの既定値は 4096 です。

WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE80x8

WS_XML_READER が WS_XML_READER_STREAM_INPUT を使用するように構成されている場合に使用するバッファーのサイズを指定する ULONG です。この値を大きくするとメモリの使用量は増えますが、WS_READ_CALLBACK が呼び出される回数を削減できます。

このプロパティの既定値は 4096 です。

WS_XML_READER_PROPERTY_IN_ATTRIBUTE90x9WsReadStartAttribute が呼び出され、リーダーが属性の内容に位置していることを示します。
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE100xA

WS_XML_READER_STREAM_INPUT を WS_XML_READER_MTOM_ENCODING と組み合わせて使用する ULONG です。この値は、ドキュメントの xml 部分を含むルート MIME パートの最大サイズを指定します。他のエンコードで使用した場合、または WS_XML_READER_BUFFER_INPUT と共に使用した場合は効果がありません。

このプロパティの既定値は 65536 です。

WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE110xB

WS_XML_READER_STREAM_INPUT を WS_XML_READER_MTOM_ENCODING と組み合わせて使用する ULONG です。この値は、ドキュメント内に出現し得る MIME ヘッダーの各グループの最大サイズを指定します。他のエンコードで使用した場合、または WS_XML_READER_BUFFER_INPUT と共に使用した場合は効果がありません。

このプロパティの既定値は 256 です。

WS_XML_READER_PROPERTY_MAX_MIME_PARTS120xC

WS_XML_READER_MTOM_ENCODING と共に使用する ULONG です。この値は、ドキュメント内に出現し得る MIME パートの最大数を指定します。他のエンコードで使用した場合は効果がありません。

このプロパティの既定値は 4096 です。

WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES130xD

WS_XML_READER_TEXT_ENCODING と共に使用する BOOL です。これを TRUE に設定すると、XML 1.0 で無効とみなされる文字の文字参照が受け入れられるようになります。

このプロパティを TRUE に設定すると、相互運用性に影響する可能性があります。

このプロパティの既定値は FALSE です。

WS_XML_READER_PROPERTY_MAX_NAMESPACES140xE

ドキュメントの読み取り中の任意の時点でスコープ内に存在できる、一意の xmlns 宣言の最大数を指定する ULONG です。

このプロパティの既定値は 32 です。

セキュリティに関する考慮事項については、WsCreateReader を参照してください。

公式ドキュメント

各 XML リーダープロパティと、それに関連付けられた値を識別します。この列挙型は WS_XML_READER_PROPERTY 構造体内で使用され、その構造体は WsCreateReader、WsSetInput、WsSetInputToBuffer、および WsReadXmlBufferFromBytes のパラメーターとして使用されます。また、WsGetReaderProperty のパラメーターとして直接使用されることもあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_XML_READER_PROPERTY_ID : int {
    WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
    WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
    WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
    WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
    WS_XML_READER_PROPERTY_CHARSET = 4,
    WS_XML_READER_PROPERTY_ROW = 5,
    WS_XML_READER_PROPERTY_COLUMN = 6,
    WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
    WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
    WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
    WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
    WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
    WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
    WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
    WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
} WS_XML_READER_PROPERTY_ID;
public enum WS_XML_READER_PROPERTY_ID : int
{
    WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
    WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
    WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
    WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
    WS_XML_READER_PROPERTY_CHARSET = 4,
    WS_XML_READER_PROPERTY_ROW = 5,
    WS_XML_READER_PROPERTY_COLUMN = 6,
    WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
    WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
    WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
    WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
    WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
    WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
    WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
    WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14,
}
Public Enum WS_XML_READER_PROPERTY_ID As Integer
    WS_XML_READER_PROPERTY_MAX_DEPTH = 0
    WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1
    WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2
    WS_XML_READER_PROPERTY_READ_DECLARATION = 3
    WS_XML_READER_PROPERTY_CHARSET = 4
    WS_XML_READER_PROPERTY_ROW = 5
    WS_XML_READER_PROPERTY_COLUMN = 6
    WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7
    WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8
    WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9
    WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10
    WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11
    WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12
    WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13
    WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
End Enum
import enum

class WS_XML_READER_PROPERTY_ID(enum.IntEnum):
    WS_XML_READER_PROPERTY_MAX_DEPTH = 0
    WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1
    WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2
    WS_XML_READER_PROPERTY_READ_DECLARATION = 3
    WS_XML_READER_PROPERTY_CHARSET = 4
    WS_XML_READER_PROPERTY_ROW = 5
    WS_XML_READER_PROPERTY_COLUMN = 6
    WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7
    WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8
    WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9
    WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10
    WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11
    WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12
    WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13
    WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
// WS_XML_READER_PROPERTY_ID
pub const WS_XML_READER_PROPERTY_MAX_DEPTH: i32 = 0;
pub const WS_XML_READER_PROPERTY_ALLOW_FRAGMENT: i32 = 1;
pub const WS_XML_READER_PROPERTY_MAX_ATTRIBUTES: i32 = 2;
pub const WS_XML_READER_PROPERTY_READ_DECLARATION: i32 = 3;
pub const WS_XML_READER_PROPERTY_CHARSET: i32 = 4;
pub const WS_XML_READER_PROPERTY_ROW: i32 = 5;
pub const WS_XML_READER_PROPERTY_COLUMN: i32 = 6;
pub const WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE: i32 = 7;
pub const WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE: i32 = 8;
pub const WS_XML_READER_PROPERTY_IN_ATTRIBUTE: i32 = 9;
pub const WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE: i32 = 10;
pub const WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE: i32 = 11;
pub const WS_XML_READER_PROPERTY_MAX_MIME_PARTS: i32 = 12;
pub const WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES: i32 = 13;
pub const WS_XML_READER_PROPERTY_MAX_NAMESPACES: i32 = 14;
// WS_XML_READER_PROPERTY_ID
const (
	WS_XML_READER_PROPERTY_MAX_DEPTH int32 = 0
	WS_XML_READER_PROPERTY_ALLOW_FRAGMENT int32 = 1
	WS_XML_READER_PROPERTY_MAX_ATTRIBUTES int32 = 2
	WS_XML_READER_PROPERTY_READ_DECLARATION int32 = 3
	WS_XML_READER_PROPERTY_CHARSET int32 = 4
	WS_XML_READER_PROPERTY_ROW int32 = 5
	WS_XML_READER_PROPERTY_COLUMN int32 = 6
	WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE int32 = 7
	WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE int32 = 8
	WS_XML_READER_PROPERTY_IN_ATTRIBUTE int32 = 9
	WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE int32 = 10
	WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE int32 = 11
	WS_XML_READER_PROPERTY_MAX_MIME_PARTS int32 = 12
	WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES int32 = 13
	WS_XML_READER_PROPERTY_MAX_NAMESPACES int32 = 14
)
const
  WS_XML_READER_PROPERTY_MAX_DEPTH = 0;
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1;
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2;
  WS_XML_READER_PROPERTY_READ_DECLARATION = 3;
  WS_XML_READER_PROPERTY_CHARSET = 4;
  WS_XML_READER_PROPERTY_ROW = 5;
  WS_XML_READER_PROPERTY_COLUMN = 6;
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7;
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8;
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9;
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10;
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11;
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12;
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13;
  WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14;
// WS_XML_READER_PROPERTY_ID
pub const WS_XML_READER_PROPERTY_MAX_DEPTH: i32 = 0;
pub const WS_XML_READER_PROPERTY_ALLOW_FRAGMENT: i32 = 1;
pub const WS_XML_READER_PROPERTY_MAX_ATTRIBUTES: i32 = 2;
pub const WS_XML_READER_PROPERTY_READ_DECLARATION: i32 = 3;
pub const WS_XML_READER_PROPERTY_CHARSET: i32 = 4;
pub const WS_XML_READER_PROPERTY_ROW: i32 = 5;
pub const WS_XML_READER_PROPERTY_COLUMN: i32 = 6;
pub const WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE: i32 = 7;
pub const WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE: i32 = 8;
pub const WS_XML_READER_PROPERTY_IN_ATTRIBUTE: i32 = 9;
pub const WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE: i32 = 10;
pub const WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE: i32 = 11;
pub const WS_XML_READER_PROPERTY_MAX_MIME_PARTS: i32 = 12;
pub const WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES: i32 = 13;
pub const WS_XML_READER_PROPERTY_MAX_NAMESPACES: i32 = 14;
const
  WS_XML_READER_PROPERTY_MAX_DEPTH* = 0
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT* = 1
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES* = 2
  WS_XML_READER_PROPERTY_READ_DECLARATION* = 3
  WS_XML_READER_PROPERTY_CHARSET* = 4
  WS_XML_READER_PROPERTY_ROW* = 5
  WS_XML_READER_PROPERTY_COLUMN* = 6
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE* = 7
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE* = 8
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE* = 9
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE* = 10
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE* = 11
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS* = 12
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES* = 13
  WS_XML_READER_PROPERTY_MAX_NAMESPACES* = 14
enum WS_XML_READER_PROPERTY_ID : int {
    WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
    WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
    WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
    WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
    WS_XML_READER_PROPERTY_CHARSET = 4,
    WS_XML_READER_PROPERTY_ROW = 5,
    WS_XML_READER_PROPERTY_COLUMN = 6,
    WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
    WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
    WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
    WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
    WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
    WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
    WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
    WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14,
}
#define global WS_XML_READER_PROPERTY_MAX_DEPTH                          0x0
#define global WS_XML_READER_PROPERTY_ALLOW_FRAGMENT                     0x1
#define global WS_XML_READER_PROPERTY_MAX_ATTRIBUTES                     0x2
#define global WS_XML_READER_PROPERTY_READ_DECLARATION                   0x3
#define global WS_XML_READER_PROPERTY_CHARSET                            0x4
#define global WS_XML_READER_PROPERTY_ROW                                0x5
#define global WS_XML_READER_PROPERTY_COLUMN                             0x6
#define global WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE                     0x7
#define global WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE                 0x8
#define global WS_XML_READER_PROPERTY_IN_ATTRIBUTE                       0x9
#define global WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE     0xA
#define global WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE       0xB
#define global WS_XML_READER_PROPERTY_MAX_MIME_PARTS                     0xC
#define global WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES 0xD
#define global WS_XML_READER_PROPERTY_MAX_NAMESPACES                     0xE