WsCreateReader 함수(webservices.h)

지정된 속성을 사용하여 XML 판독 기를 만듭니다.

구문

HRESULT WsCreateReader(
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_READER                **reader,
  [in, optional] WS_ERROR                     *error
);

매개 변수

properties

XML 판독기의 선택적 속성을 포함하는 WS_XML_READER_PROPERTY 구조체의 배열입니다.

이 매개 변수의 값은 NULL일 수 있습니다. 이 경우 propertyCount 매개 변수는 0이어야 합니다.

tiy에서 XML 판독기를 구성하는 데 사용할 수 있는 속성은 WS_XML_READER_PROPERTY_ID 열거형을 참조하세요.

[in] propertyCount

속성 배열의 속성 수입니다.

reader

성공하면 새 XML 판독기를 나타내는 WS_XML_READER 구조체의 주소를 받는 포인터입니다.

이 구조체가 더 이상 필요하지 않은 경우 WsFreeReader를 호출하여 해제해야 합니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 수신하는 WS_ERROR 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 HRESULT 오류 코드가 반환됩니다.

설명

WsSetInput 또는 WsSetInputToBuffer 함수를 사용하여 XML 판독기의 인코딩을 선택하고 입력 소스를 나타냅니다.

WsSetInput 함수에 전달된 WS_XML_READER_INPUT 구조에서 WS_READ_CALLBACK 지정한 경우 XML 판독기는 WsFillReader가 호출될 때만 추가 데이터를 읽습니다. 이를 통해 호출자는 데이터를 읽을 세분성 및 해당 데이터를 비동기적으로 읽을지 여부를 결정할 수 있습니다.

WsSetInput 또는 WsSetInputToBuffer를 다시 호출 하여 WS_XML_READER 구조를 다시 사용할 수 있습니다.

WS_XML_READER 작동하는 API 작업이 실패하면 XML 판독기가 오류 상태로 남아 있고 추가 함수 호출은 WS_E_OBJECT_FAULTED 반환합니다. ( Windows Web Services 반환 값을 참조하세요.) 이 경우 XML 판독기를 사용할 수 있는 상태로 되돌리기 위한 WsSetInput 및 WsSetInputToBuffer 또는 XML 판독기 개체를 해제하기 위한 WsFreeReader 만 XML 판독기를 호출할 수 있습니다.

요구 사항

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