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 앱]
머리글	webservices.h