WsWriteText 함수(webservices.h)

지정된 텍스트를 XML 기록기에 씁니다.

특성 값에 문자를 쓰려면 WsWriteStartAttribute를 호출합니다. WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENTTRUE로 설정되지 않은 경우 xml 문서의 루트에 공백 문자만 쓸 수 있습니다.

구문

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

매개 변수

[in] writer

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

[in] text

쓸 텍스트에 대한 포인터입니다.

참고 텍스트 개체에 대한 자세한 내용은 WS_XML_TEXT 및 파생 클래스를 참조하세요.

 

[in, optional] error

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

반환 값

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

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

설명

텍스트 형식이 다음 중 하나가 아닌 한 WsWriteStartAttribute와 WsWriteEndAttribute 간에 WsWriteText를 한 번만 호출할 수 있습니다.

• WS_XML_TEXT_TYPE_UTF8
• WS_XML_TEXT_TYPE_UTF16
• WS_XML_TEXT_TYPE_BASE64

참고 텍스트 형식이 이전 값 중 하나로 설정된 경우 WsWriteText를 두 번 이상 호출할 수 있습니다. 그러나 특성 내의 모든 호출에 대해 형식 텍스트가 동일해야 합니다.

 

요구 사항

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