WsReadCharsUtf8 함수(webservices.h)

판독기에서 지정된 수의 텍스트 문자를 읽고 UTF-8로 인코딩된 텍스트를 반환합니다.

구문

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

매개 변수

[in] reader

문자 데이터를 읽어야 하는 XML 판독 기를 가리키는 포인터입니다. 포인터는 유효한 WS_XML_READER 개체를 참조해야 합니다.

bytes

읽은 인코딩된 바이트를 배치하는 버퍼에 대한 포인터입니다.

[in] maxByteCount

읽어야 하는 최대 바이트 수입니다.

[out] actualByteCount

읽은 실제 바이트 수의 ULONG 값에 대한 포인터입니다. 남은 바이트가 더 많은 경우에도 maxByteCount보다 작을 수 있습니다. 이 값이 0을 반환하면 더 이상 바이트가 없습니다.

[in, optional] error

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

반환 값

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

반환 코드	설명
WS_E_INVALID_FORMAT	입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
WS_E_QUOTA_EXCEEDED	할당량을 초과했습니다.

설명

XML 텍스트는 start 요소 또는 끝 요소까지 읽습니다. 주석은 건너뛰고 CDATA 콘텐츠는 요소 콘텐츠와 동일하게 처리됩니다. 문자 엔터티는 이스케이프되지 않은 형식으로 변환됩니다.

이 함수는 WsReadNode에 나열된 이유 중 어떤 이유로든 실패할 수 있습니다.

요구 사항

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