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 개체에 대한 포인터입니다.
반환 값
이 함수는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
하나 이상의 인수가 잘못되었습니다. |
|
개체의 현재 상태로 인해 작업이 허용되지 않습니다. |
설명
WsWriteValue 는 WsWriteStartAttribute 와 WsWriteEndAttribute 간에 한 번만 호출할 수 있습니다. 특성을 작성할 때 WsWriteChars, WsWriteBytes, WsWriteCharsUtf8 또는 WsWriteText 와 결합되지 않을 수 있습니다.
요구 사항
지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | webservices.h |
라이브러리 | WebServices.lib |
DLL | WebServices.dll |