WsWriteValue 함수(webservices.h)

이 작업은 기본 인코딩에서 기본 값에 대한 최상의 표현을 파생하고 파생된 값을 Writer 개체에 전달합니다.

참고 일반적으로 이 함수를 사용하여 값을 텍스트로 변환하고 이후에 WsWriteChars를 사용하는 대신 기본 값을 작성하는 것이 더 효율적입니다.

 

구문

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

매개 변수

[in] writer

값이 기록되는 WS_XML_WRITER 개체에 대한 포인터입니다. 포인터는 유효한 XML 기록 기 개체를 참조해야 합니다.

[in] valueType

value 매개 변수에서 참조하는 기본 값의 형식을 나타냅니다.

I

value

기본값에 대한 void 포인터입니다.

[in] valueSize

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

[in, optional] error

함수가 실패할 경우 오류에 대한 추가 정보를 저장해야 하는 WS_ERROR 개체에 대한 포인터입니다.

반환 값

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

반환 코드	설명
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
WS_E_INVALID_OPERATION	개체의 현재 상태로 인해 작업이 허용되지 않습니다.

설명

WsWriteValue 는 WsWriteStartAttribute 와 WsWriteEndAttribute 간에 한 번만 호출할 수 있습니다. 특성을 작성할 때 WsWriteChars, WsWriteBytes, WsWriteCharsUtf8 또는 WsWriteText 와 결합되지 않을 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	webservices.h
라이브러리	WebServices.lib
DLL	WebServices.dll