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

WS_ENCODING

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

メンバー 9

名前10進16進説明
WS_ENCODING_XML_BINARY_100x0

バイナリ XML エンコーディングです。

データは引き続き XML インフォセット形式ですが、このエンコーディングでは通常、メッセージのサイズが小さくなり、生成と読み取りに必要な CPU も少なくなります。

このエンコーディングには SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2) が必要です。

WS_ENCODING_XML_BINARY_SESSION_110x1

バイナリ XML セッション エンコーディングです。

データは引き続き XML インフォセット形式ですが、このエンコーディングでは通常、メッセージのサイズが小さくなり、生成と読み取りに必要な CPU も少なくなります。

このエンコーディングは WS_ENCODING_XML_BINARY_1 と似ていますが、セッション ディクショナリの機能が追加されています。このエンコーディングはセッションを必要とするため、セッションを持つチャネル型 (WS_CHANNEL_TYPE_DUPLEX_SESSION) でのみ使用できます。

セッション ディクショナリは、チャネルの送信側と受信側の両方で保持されるデータ構造です。セッション ディクショナリは、文字列データの転送を最適化するために使用されます。特定の文字列が最初に書き込まれるときは、完全な文字列形式でエンコードされます。同じ文字列が再度書き込まれる場合は、より小さいトークン化された形式が使用されるため、メッセージのサイズを削減できます。

文字列データの書き込み側は、WS_XML_STRING 構造体の dictionary フィールドと id フィールドを設定することで、セッション ディクショナリの候補とする文字列を選択します。

セッション ディクショナリのサイズは WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE を使用して構成します。

このエンコーディングには SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2) が必要です。

WS_ENCODING_XML_MTOM_UTF820x2

MTOM エンコーディングです。

MTOM エンコーディングは、バイナリ データを base64 形式に変換するコストを回避することで、バイナリ データを最適化します。大量のバイナリ データを含むメッセージでは、このエンコーディングは通常、テキスト エンコーディングよりもメッセージのサイズが小さくなり、生成と読み取りに必要な CPU も少なくなります。ただし、このエンコーディングは一般にバイナリ エンコーディングほど効率的ではありません。

MTOM パッケージの XML 部分は WS_CHARSET_UTF8 を使用して書き込まれますが、読み取り時には任意の WS_CHARSET である可能性があります。

WS_ENCODING_XML_MTOM_UTF16BE30x3

MTOM エンコーディングです。

MTOM エンコーディングは、バイナリ データを base64 形式に変換するコストを回避することで、バイナリ データを最適化します。大量のバイナリ データを含むメッセージでは、このエンコーディングは通常、テキスト エンコーディングよりもメッセージのサイズが小さくなり、生成と読み取りに必要な CPU も少なくなります。ただし、このエンコーディングは一般にバイナリ エンコーディングほど効率的ではありません。

MTOM パッケージの XML 部分は WS_CHARSET_UTF16BE を使用して書き込まれますが、読み取り時には任意の WS_CHARSET である可能性があります。

WS_ENCODING_XML_MTOM_UTF16LE40x4

MTOM エンコーディングです。

MTOM エンコーディングは、バイナリ データを base64 形式に変換するコストを回避することで、バイナリ データを最適化します。大量のバイナリ データを含むメッセージでは、このエンコーディングは通常、テキスト エンコーディングよりもメッセージのサイズが小さくなり、生成と読み取りに必要な CPU も少なくなります。ただし、このエンコーディングは一般にバイナリ エンコーディングほど効率的ではありません。

MTOM パッケージの XML 部分は WS_CHARSET_UTF16LE を使用して書き込まれますが、読み取り時には任意の WS_CHARSET である可能性があります。

WS_ENCODING_XML_UTF850x5

テキスト エンコーディング (XML 1.0 形式) です。

データは WS_CHARSET_UTF8 を使用して書き込まれますが、読み取り時には任意の WS_CHARSET である可能性があります。

WS_ENCODING_XML_UTF16BE60x6

テキスト エンコーディング (XML 1.0 形式) です。

データは WS_CHARSET_UTF16BE を使用して書き込まれますが、読み取り時には任意の WS_CHARSET である可能性があります。

WS_ENCODING_XML_UTF16LE70x7

テキスト エンコーディング (XML 1.0 形式) です。

データは WS_CHARSET_UTF16LE を使用して書き込まれますが、読み取り時には任意の WS_CHARSET である可能性があります。

WS_ENCODING_RAW80x8

公式ドキュメント

さまざまなエンコーディング (メッセージ形式) です。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ENCODING : int {
    WS_ENCODING_XML_BINARY_1 = 0,
    WS_ENCODING_XML_BINARY_SESSION_1 = 1,
    WS_ENCODING_XML_MTOM_UTF8 = 2,
    WS_ENCODING_XML_MTOM_UTF16BE = 3,
    WS_ENCODING_XML_MTOM_UTF16LE = 4,
    WS_ENCODING_XML_UTF8 = 5,
    WS_ENCODING_XML_UTF16BE = 6,
    WS_ENCODING_XML_UTF16LE = 7,
    WS_ENCODING_RAW = 8
} WS_ENCODING;
public enum WS_ENCODING : int
{
    WS_ENCODING_XML_BINARY_1 = 0,
    WS_ENCODING_XML_BINARY_SESSION_1 = 1,
    WS_ENCODING_XML_MTOM_UTF8 = 2,
    WS_ENCODING_XML_MTOM_UTF16BE = 3,
    WS_ENCODING_XML_MTOM_UTF16LE = 4,
    WS_ENCODING_XML_UTF8 = 5,
    WS_ENCODING_XML_UTF16BE = 6,
    WS_ENCODING_XML_UTF16LE = 7,
    WS_ENCODING_RAW = 8,
}
Public Enum WS_ENCODING As Integer
    WS_ENCODING_XML_BINARY_1 = 0
    WS_ENCODING_XML_BINARY_SESSION_1 = 1
    WS_ENCODING_XML_MTOM_UTF8 = 2
    WS_ENCODING_XML_MTOM_UTF16BE = 3
    WS_ENCODING_XML_MTOM_UTF16LE = 4
    WS_ENCODING_XML_UTF8 = 5
    WS_ENCODING_XML_UTF16BE = 6
    WS_ENCODING_XML_UTF16LE = 7
    WS_ENCODING_RAW = 8
End Enum
import enum

class WS_ENCODING(enum.IntEnum):
    WS_ENCODING_XML_BINARY_1 = 0
    WS_ENCODING_XML_BINARY_SESSION_1 = 1
    WS_ENCODING_XML_MTOM_UTF8 = 2
    WS_ENCODING_XML_MTOM_UTF16BE = 3
    WS_ENCODING_XML_MTOM_UTF16LE = 4
    WS_ENCODING_XML_UTF8 = 5
    WS_ENCODING_XML_UTF16BE = 6
    WS_ENCODING_XML_UTF16LE = 7
    WS_ENCODING_RAW = 8
// WS_ENCODING
pub const WS_ENCODING_XML_BINARY_1: i32 = 0;
pub const WS_ENCODING_XML_BINARY_SESSION_1: i32 = 1;
pub const WS_ENCODING_XML_MTOM_UTF8: i32 = 2;
pub const WS_ENCODING_XML_MTOM_UTF16BE: i32 = 3;
pub const WS_ENCODING_XML_MTOM_UTF16LE: i32 = 4;
pub const WS_ENCODING_XML_UTF8: i32 = 5;
pub const WS_ENCODING_XML_UTF16BE: i32 = 6;
pub const WS_ENCODING_XML_UTF16LE: i32 = 7;
pub const WS_ENCODING_RAW: i32 = 8;
// WS_ENCODING
const (
	WS_ENCODING_XML_BINARY_1 int32 = 0
	WS_ENCODING_XML_BINARY_SESSION_1 int32 = 1
	WS_ENCODING_XML_MTOM_UTF8 int32 = 2
	WS_ENCODING_XML_MTOM_UTF16BE int32 = 3
	WS_ENCODING_XML_MTOM_UTF16LE int32 = 4
	WS_ENCODING_XML_UTF8 int32 = 5
	WS_ENCODING_XML_UTF16BE int32 = 6
	WS_ENCODING_XML_UTF16LE int32 = 7
	WS_ENCODING_RAW int32 = 8
)
const
  WS_ENCODING_XML_BINARY_1 = 0;
  WS_ENCODING_XML_BINARY_SESSION_1 = 1;
  WS_ENCODING_XML_MTOM_UTF8 = 2;
  WS_ENCODING_XML_MTOM_UTF16BE = 3;
  WS_ENCODING_XML_MTOM_UTF16LE = 4;
  WS_ENCODING_XML_UTF8 = 5;
  WS_ENCODING_XML_UTF16BE = 6;
  WS_ENCODING_XML_UTF16LE = 7;
  WS_ENCODING_RAW = 8;
// WS_ENCODING
pub const WS_ENCODING_XML_BINARY_1: i32 = 0;
pub const WS_ENCODING_XML_BINARY_SESSION_1: i32 = 1;
pub const WS_ENCODING_XML_MTOM_UTF8: i32 = 2;
pub const WS_ENCODING_XML_MTOM_UTF16BE: i32 = 3;
pub const WS_ENCODING_XML_MTOM_UTF16LE: i32 = 4;
pub const WS_ENCODING_XML_UTF8: i32 = 5;
pub const WS_ENCODING_XML_UTF16BE: i32 = 6;
pub const WS_ENCODING_XML_UTF16LE: i32 = 7;
pub const WS_ENCODING_RAW: i32 = 8;
const
  WS_ENCODING_XML_BINARY_1* = 0
  WS_ENCODING_XML_BINARY_SESSION_1* = 1
  WS_ENCODING_XML_MTOM_UTF8* = 2
  WS_ENCODING_XML_MTOM_UTF16BE* = 3
  WS_ENCODING_XML_MTOM_UTF16LE* = 4
  WS_ENCODING_XML_UTF8* = 5
  WS_ENCODING_XML_UTF16BE* = 6
  WS_ENCODING_XML_UTF16LE* = 7
  WS_ENCODING_RAW* = 8
enum WS_ENCODING : int {
    WS_ENCODING_XML_BINARY_1 = 0,
    WS_ENCODING_XML_BINARY_SESSION_1 = 1,
    WS_ENCODING_XML_MTOM_UTF8 = 2,
    WS_ENCODING_XML_MTOM_UTF16BE = 3,
    WS_ENCODING_XML_MTOM_UTF16LE = 4,
    WS_ENCODING_XML_UTF8 = 5,
    WS_ENCODING_XML_UTF16BE = 6,
    WS_ENCODING_XML_UTF16LE = 7,
    WS_ENCODING_RAW = 8,
}
#define global WS_ENCODING_XML_BINARY_1         0x0
#define global WS_ENCODING_XML_BINARY_SESSION_1 0x1
#define global WS_ENCODING_XML_MTOM_UTF8        0x2
#define global WS_ENCODING_XML_MTOM_UTF16BE     0x3
#define global WS_ENCODING_XML_MTOM_UTF16LE     0x4
#define global WS_ENCODING_XML_UTF8             0x5
#define global WS_ENCODING_XML_UTF16BE          0x6
#define global WS_ENCODING_XML_UTF16LE          0x7
#define global WS_ENCODING_RAW                  0x8