Share via

WsReadMetadata 함수(webservices.h)

  • 아티클

메타데이터 요소를 읽고 메타데이터 개체의 메타데이터 문서에 추가합니다.

메타데이터 개체 상태는 WS_METADATA_STATE_CREATED 설정해야 합니다.

오류 발생 시 메타데이터 개체 상태가 WS_METADATA_STATE_FAULTED 다시 설정됩니다.

참고 요소에 메타데이터가 포함된 경우 함수는 요소를 사용합니다. 요소가 메타데이터를 포함하는 것으로 인식되지 않거나 특정 형식의 메타데이터가 필요하지 않은 경우 읽지 않는 요소입니다.
 

구문

HRESULT WsReadMetadata(
  [in]           WS_METADATA     *metadata,
  [in]           WS_XML_READER   *reader,
  [in]           const WS_STRING *url,
  [in, optional] WS_ERROR        *error
);

매개 변수

[in] metadata

메타데이터 읽기를 저장하기 위한 메타데이터 개체에 대한 포인터입니다. 포인터는 유효한 WS_METADATA 개체를 참조해야 합니다.

[in] reader

메타데이터를 읽는 데 사용되는 XML Reader 개체에 대한 포인터입니다. 포인터는 유효한 WS_XML_READER 개체를 참조해야 하며 판독기는 원하는 메타데이터를 포함하는 요소에 배치되어야 합니다.

[in] url

검색된 메타데이터 URL을 참조하는 WS_STRING 개체에 대한 포인터입니다. URL은 문서 간의 URL 기반 링크를 확인하기 위한 메타데이터 문서를 추적하는 데 사용됩니다.

참고 URL은 정규화되어야 합니다. URL에는 조각 식별자가 있을 수 있습니다.
 

지원되는 URL 체계는 다음과 같습니다.

  • WS_URL_HTTP_SCHEME_TYPE
  • WS_URL_HTTPS_SCHEME_TYPE
  • WS_URL_NETTCP_SCHEME_TYPE
이 함수를 사용하여 지정된 각 URL에는 고유한 기본 URL이 있어야 합니다. 기본 URL은 지정된 URL에서 조각 식별자를 제거하여 계산됩니다.

예를 들어 다음 URL을 지정한 경우입니다.


http://example.com/document1#fragment
http://example.com/document2

두 가지 기본 URL은 다음과 같습니다.


http://example.com/document1
http://example.com/document2

[in, optional] error

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

반환 값

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

반환 코드 설명
WS_E_INVALID_FORMAT
 입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
WS_E_INVALID_OPERATION
 개체의 현재 상태로 인해 작업이 허용되지 않습니다.
WS_E_QUOTA_EXCEEDED
 할당량을 초과했습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
S_FALSE
 요소가 사용되지 않았습니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

이 함수는 다음과 같은 유형의 메타데이터를 인식합니다.

  • WSDL 1.1 문서
  • WS-Policy 1.2 문서

요구 사항

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