WS_WRITE_TYPE_CALLBACK 콜백 함수(webservices.h)

WS_CUSTOM_TYPE 지정되었을 때 요소를 작성하기 위해 호출됩니다. 이렇게 하면 핵심 serialization 모델에 쉽게 매핑되지 않는 XML 구문을 작성할 수 있습니다.

구문

WS_WRITE_TYPE_CALLBACK WsWriteTypeCallback;

HRESULT WsWriteTypeCallback(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           const void *descriptionData,
                 const void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

매개 변수

[in] writer

값을 작성해야 하는 기록기에 대한 WS_XML_WRITER 포인터입니다.

[in] typeMapping

XML이 이 형식에 매핑되는 방식을 나타냅니다. 자세한 내용은 WS_TYPE_MAPPING 참조하세요.

이 특정 형식에 대한 매핑이 의미가 없는 경우 콜백은 WS_E_INVALID_OPERATION 반환해야 합니다. ( Windows Web Services 반환 값을 참조하세요.) 콜백 구현은 이후 버전에서 새 매핑 형식을 전달할 준비가 되어 있어야 하며 이러한 경우에 대한 WS_E_INVALID_OPERATION 반환해야 합니다.

[in] descriptionData

이는 WS_CUSTOM_TYPE_DESCRIPTION 구조체의 descriptionData 필드 값입니다. 콜백은 이 필드를 사용하여 형식에 대한 추가 정보에 액세스합니다.

value

serialize할 값에 대한 void 포인터입니다.

[in] valueSize

serialize되는 값의 크기(바이트)입니다.

[in, optional] error

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

반환 값

이 콜백 함수는 값을 반환하지 않습니다.

설명

콜백은 WS_TYPE_MAPPING 설명서에서 WsWriteType과 동일한 호출 시퀀스로 호출됩니다. 이는 콜백에서 작성해야 하는 XML의 부분을 정의합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	webservices.h