다음을 통해 공유

WS_FIELD_DESCRIPTION 구조체(webservices.h)

  • 아티클

구조체 내의 필드에 대한 serialization 정보를 나타냅니다.

구문

typedef struct _WS_FIELD_DESCRIPTION {
  WS_FIELD_MAPPING mapping;
  WS_XML_STRING    *localName;
  WS_XML_STRING    *ns;
  WS_TYPE          type;
  void             *typeDescription;
  ULONG            offset;
  ULONG            options;
  WS_DEFAULT_VALUE *defaultValue;
  ULONG            countOffset;
  WS_XML_STRING    *itemLocalName;
  WS_XML_STRING    *itemNs;
  WS_ITEM_RANGE    *itemRange;
} WS_FIELD_DESCRIPTION;

멤버

mapping

필드가 XML에 매핑하는 방법을 식별합니다. XML 콘텐츠에서 필드를 노출할 수 있는 방법은 WS_FIELD_MAPPING 참조하세요.

localName

필드에 사용할 XML 로컬 이름입니다.

이 필드는 NULL일 수 있는 다음 경우를 제외하고 필요합니다. 매핑 필드가 WS_REPEATING_ELEMENT_FIELD_MAPPING 경우 배열 항목 요소의 부모 요소인 "래퍼" 요소의 로컬 이름을 식별합니다. 이 필드(및 ns 필드)를 NULL 로 설정하면 래퍼 요소가 생략됩니다. ns 및 localName 필드는 모두 지정되거나 NULL이어야 합니다.

ns

필드에 사용할 XML 네임스페이스입니다.

이 필드는 NULL일 수 있는 다음 경우를 제외하고 필요합니다. 매핑 필드가 WS_REPEATING_ELEMENT_FIELD_MAPPING 경우 배열 항목 요소의 부모 요소인 "래퍼" 요소의 네임스페이스를 식별합니다. 이 필드(및 localName 필드)를 NULL 로 설정하면 래퍼 요소가 생략됩니다. ns 및 localName 필드는 모두 지정되거나 NULL이어야 합니다.

type

필드의 형식입니다. 지원되는 형식 목록은 WS_TYPE 참조하세요.

typeDescription

형식에 대한 추가 정보입니다. 각 형식에는 다른 설명 구조가 있습니다. WS_TYPE 따라 NULL일 수 있습니다.

offset

포함하는 구조체 내의 필드 오프셋입니다.

options

필드에 대한 추가 플래그입니다. 플래그 목록은 WS_FIELD_OPTIONS 참조하세요. 플래그가 필요하지 않은 경우 0일 수 있습니다.

defaultValue

필드의 기본값을 가리킵니다. 다음 인스턴스에서 사용됩니다.

defaultValue가 NULL이면 모든 0의 기본값을 갖는 것과 같습니다.

countOffset

배열의 항목 수를 나타내는 ULONG 필드의 구조 오프셋입니다.

이 필드는 WS_REPEATING_ELEMENT_FIELD_MAPPING 또는 배열 형식(WS_CHAR_ARRAY_TYPE, WS_UTF8_ARRAY_TYPE, WS_BYTE_ARRAY_TYPE)을 사용할 때 사용됩니다.
다른 경우에는 지정할 필요가 없습니다(0일 수 있음).

itemLocalName

WS_REPEATING_ELEMENT_FIELD_MAPPING 사용할 때 반복 요소에 사용할 XML 로컬 이름입니다.

다른 경우에는 이 필드를 지정할 필요가 없습니다( NULL일 수 있음).

itemNs

WS_REPEATING_ELEMENT_FIELD_MAPPING 사용할 때 반복 요소에 사용할 XML 네임스페이스입니다.

다른 경우에는 이 필드를 지정할 필요가 없습니다( NULL일 수 있음).

itemRange

WS_REPEATING_ELEMENT_FIELD_MAPPING, WS_REPEATING_ELEMENT_CHOICE_FIELD_MAPPING 또는WS_REPEATING_ANY_ELEMENT_FIELD_MAPPING 사용할 때 나타날 수 있는 반복 요소의 최소 및 최대 수입니다. 지정하지 않은 경우(NULL), 최소값은 0이고 최댓값은 MAX ULONG입니다.

다른 경우에는 이 필드를 지정할 필요가 없습니다( NULL일 수 있음).

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글 webservices.h