WsCreateWriter 함수(webservices.h)

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

구문

HRESULT WsCreateWriter(
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_WRITER                **writer,
  [in, optional] WS_ERROR                     *error
);

매개 변수

properties

XML 작성기에 대한 선택적 속성을 포함하는 WS_XML_WRITER_PROPERTY 구조체의 배열입니다.

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

[in] propertyCount

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

writer

성공하면 생성된 XML 작성기를 나타내는 WS_XML_WRITER 구조체의 주소를 받는 포인터입니다.

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

[in, optional] error

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

반환 값

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

설명

WsSetOutput 또는 WsSetOutputToBuffer 함수를 사용하여 XML 기록기의 인코딩을 선택하고 출력을 지시할 위치를 나타냅니다.

WsSetOutput 또는 WsSetOutputToBuffer를 다시 호출하여 WS_XML_WRITER 다시 사용할 수 있습니다.

작성기를 구성하는 데 사용할 수 있는 속성은 WS_XML_WRITER_PROPERTY_ID 참조하세요.

XML 기록기는 WsFlushWriter 가 호출될 때까지 모든 데이터를 버퍼링합니다. 이를 통해 호출자는 데이터를 쓸 세분성 및 해당 데이터를 비동기적으로 쓸지 여부를 결정할 수 있습니다. WsFlushWriter가 호출될 때까지 데이터가 기록되지 않습니다.

WS_XML_WRITER 대한 작업이 실패하면 기록기는 오류 상태로 남아 있고 기록기에 대한 추가 호출은 WS_E_OBJECT_FAULTED 반환합니다. ( Windows Web Services 반환 값을 참조하세요.) 이 경우 XML 작성기를 호출할 수 있는 유일한 함수는 WsSetOutput 및 WsSetOutputToBuffer 를 사용하여 XML 작성기를 사용 가능한 상태로 반환하거나 WsFreeWriter 를 호출하여 XML 작성기를 해제합니다.

요구 사항