WS_XML_DICTIONARY構造体 (webservices.h)

一意の文字列のセットを表します。 この情報は、バイナリ エンコードによって使用され、よりコンパクトな xml ドキュメントを書き込みます。

構文

typedef struct _WS_XML_DICTIONARY {
  GUID          guid;
  WS_XML_STRING *strings;
  ULONG         stringCount;
  BOOL          isConst;
} WS_XML_DICTIONARY;

メンバー

guid

ディクショナリで表される文字列のセットを一意に識別する guid。 guid は送信も永続化も行われず、プロセスの有効期間中のみ一意である必要があります。

strings

ディクショナリを構成する一意の文字列のセット。

stringCount

ディクショナリ内の文字列の数を指定します。

isConst

ディクショナリとその内容が const として宣言されているかどうかを示し、ディクショナリ内の文字列が使用されるオブジェクトの有効期間全体にわたって有効な状態を維持することを示します。

これが TRUE の場合は、文字列をより効率的に操作できます。

注釈

ディクショナリ内のすべての文字列と値は一意である必要があります。 辞書は常に整形式であると見なされるため、辞書の作成者がそうであることを確認してください。

ディクショナリは、次のように宣言できます。

struct PurchaseOrderDictionary
{
    WS_XML_DICTIONARY dictionary;
    WS_XML_STRING quantity;
    WS_XML_STRING productName;
    WS_XML_STRING purchaseOrder;
    WS_XML_STRING purchaseOrderNamespace;
};

static PurchaseOrderDictionary purchaseOrderDictionary =
{
    { 
        { /* A unique GUID generated from uuidgen */ },
        &purchaseOrderDictionary.quantity,
        4, 
        TRUE 
    },
    WS_XML_STRING_DICTIONARY_VALUE("Quantity",           &purchaseOrderDictionary.dictionary, 0),
    WS_XML_STRING_DICTIONARY_VALUE("ProductName",        &purchaseOrderDictionary.dictionary, 1),
    WS_XML_STRING_DICTIONARY_VALUE("PurchaseOrder",      &purchaseOrderDictionary.dictionary, 2),
    WS_XML_STRING_DICTIONARY_VALUE("http://example.com", &purchaseOrderDictionary.dictionary, 3),
};

ディクショナリの文字列は、次のように使用できます。

WsWriteStartElement(xmlWriter, NULL, &purchaseOrderDictionary.purchaseOrder, &purchaseOrderDictionary.purchaseOrderNamespace, error);

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
Header	webservices.h