WsReadArray 함수(webservices.h)

판독기에서 일련의 요소를 읽고 지정된 값 형식에 따라 해당 콘텐츠를 해석합니다.

구문

HRESULT WsReadArray(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 void                *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [out]          ULONG               *actualItemCount,
  [in, optional] WS_ERROR            *error
);

매개 변수

[in] reader

배열을 읽어야 하는 판독기입니다.

[in] localName

반복 요소의 localName입니다.

[in] ns

반복 요소의 네임스페이스입니다.

[in] valueType

각 요소의 콘텐츠를 구문 분석하는 데 사용할 값 형식입니다.

array

구문 분석된 값으로 채울 배열입니다. 배열 항목의 크기는 값 형식에 따라 결정됩니다. 자세한 내용은 WS_VALUE_TYPE 참조하세요.

[in] arraySize

배열의 크기(항목 아님)입니다.

[in] itemOffset

읽을 배열 내의 항목(바이트 아님) 오프셋입니다.

[in] itemCount

배열로 읽을 항목 수(바이트 아님)입니다.

[out] actualItemCount

읽은 실제 항목 수입니다. 남은 항목이 더 많은 경우에도 itemCount보다 작을 수 있습니다. 이 값이 0을 반환하는 경우 더 이상 요소가 없습니다.

[in, optional] error

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

반환 값

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

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

설명

이 함수는 WsReadStartElement, WsReadValue 및 WsReadEndElement를 루프에서 사용하는 것과 의미상 동일하지만 더 효율적입니다.

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

요구 사항

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