WsWriteElement 함수(webservices.h)

형식화된 값을 XML 요소로 작성합니다.

구문

HRESULT WsWriteElement(
  [in]           WS_XML_WRITER                *writer,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

매개 변수

[in] writer

요소를 쓸 작성기입니다.

[in] elementDescription

요소를 serialize하는 방법에 대한 설명에 대한 포인터입니다.

[in] writeOption

값이 할당되는 방법에 대한 정보입니다. 자세한 내용은 WS_WRITE_OPTION 참조하세요.

value

serialize할 값에 대한 포인터입니다.

[in] valueSize

serialize되는 값의 크기(바이트)입니다.

값이 NULL이면 크기는 0이어야 합니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

설명

이 API는 start 요소, 특성, 자식 요소/텍스트 및 지정된 값에 해당하는 끝 요소를 씁니다.

API가 실패하면 입력 기록기의 상태가 정의되지 않습니다. 이 경우 작성기에서 사용할 수 있는 유일한 API는 WsSetOutput 및 WsSetOutputToBuffer 를 사용하여 작성기를 사용 가능한 상태로 되돌리거나 WsFreeWriter 를 사용하여 작성기를 해제합니다.

요구 사항