WS_WRITE_OPTION 열거형(webservices.h)

  • 아티클

지정된 스토리지에 값 또는 값에 대한 포인터가 포함되어 있는지 여부와 XML 콘텐츠에서 값을 nil로 나타낼 수 있는지 여부를 지정합니다.

Syntax

typedef enum {
  WS_WRITE_REQUIRED_VALUE = 1,
  WS_WRITE_REQUIRED_POINTER = 2,
  WS_WRITE_NILLABLE_VALUE = 3,
  WS_WRITE_NILLABLE_POINTER = 4
} WS_WRITE_OPTION;

상수

 
WS_WRITE_REQUIRED_VALUE
값: 1
지정된 스토리지에 값이 포함됩니다. 스토리지의 크기
지정된 값의 크기여야 합니다.


이 옵션은 값이 항상 XML 콘텐츠에 기록되도록 지정합니다.



syntax<br>int value;<br>Api(..., &amp;value, sizeof(value), ...);<br>


syntax<br>// always written<br>&lt;element&gt;123&lt;/element&gt;<br>

이 옵션은 포인터 형식에 대해 지원되지 않습니다.
(WS_WSZ_TYPE 및 WS_XML_BUFFER_TYPE).
WS_WRITE_REQUIRED_POINTER 옵션은 이러한 형식에 사용해야 합니다.
WS_WRITE_REQUIRED_POINTER
값: 2
지정된 스토리지에 값에 대한 포인터가 포함되어 있습니다. The
지정된 스토리지의 크기는 항상 포인터의 크기입니다.
직렬화되는 형식의 입니다.


이 옵션은 값이 항상 XML 콘텐츠에 기록되도록 지정합니다.



syntax<br>int* valuePointer; // may not be NULL<br>Api(..., &amp;valuePointer, sizeof(valuePointer), ...);<br>


syntax<br>// always written<br>&lt;element&gt;123&lt;/element&gt;<br>

스토리지에 지정된 값에 대한 포인터가 NULL이면
E_INVALIDARG 반환됩니다.
( Windows Web Services 반환 값을 참조하세요.)
WS_WRITE_NILLABLE_VALUE
값: 3
지정된 스토리지에 값에 대한 포인터가 포함되어 있습니다. The
지정된 스토리지의 크기는 항상 포인터의 크기입니다.
직렬화되는 형식의 입니다.


값이 nil이면 Nil 요소가 XML 콘텐츠에 기록됩니다.
nil이 아닌 경우 값이 정상적으로 직렬화됩니다.



syntax<br>WS_STRING value; // may contain a nil value (see WS_STRING_TYPE)<br>Api(..., &amp;value, sizeof(value), ...);<br>


syntax<br>// if value is non-nil<br>&lt;element&gt;hello&lt;/element&gt;<br><br>// if value is nil<br>&lt;element xsi:nil='true'/&gt;<br>

이 옵션은 아래에 나열된 다음 형식에 대해서만 지원됩니다.
nil 값을 나타내는 기본 방법이 있는 입니다. 설명서를 참조하세요.
nil이 표현되는 방법에 대한 자세한 내용은 각 형식에 대한 입니다.
WS_WRITE_NILLABLE_POINTER
값: 4
모든 형식에 대해 지정된 스토리지에는 값에 대한 포인터가 포함됩니다. The
지정된 스토리지의 크기는 항상 포인터의 크기입니다.
직렬화되는 형식의 입니다.


스토리지에 지정된 값에 대한 포인터가 NULL이면
Nil 요소는 XML 콘텐츠에 기록됩니다.



syntax<br>int* valuePointer; // may be NULL<br>Api(..., &amp;valuePointer, sizeof(valuePointer), ...);<br><br>


syntax<br>// if value is non-NULL<br>&lt;element&gt;123&lt;/element&gt;<br><br>// if value is NULL<br>&lt;element xsi:nil='true'/&gt;<br>

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
머리글 webservices.h