WsGetMetadataEndpoints 함수(webservices.h)

메타데이터 개체 문서에 정의된 "엔드포인트"를 반환합니다. WS_METADATA_STATE WS_METADATA_STATE_CREATED설정하여 이 함수를 호출하면 메타데이터 개체가 메타데이터 문서의 모든 참조를 resolve. 추가 문서 유효성 검사도 수행됩니다. 이 프로세스가 성공하면 메타데이터 개체가 WS_METADATA_STATE_RESOLVED 설정되고 메타데이터 개체에 대한 후속 문서 추가는 허용되지 않습니다. 오류가 발생하면 메타데이터 개체가 WS_METADATA_STATE_FAULTED 설정됩니다.

참고 이 함수에서 반환된 데이터는 메타데이터 개체가 해제되거나 다시 설정될 때까지 유효합니다. 이 함수에서 반환된 데이터는 수정하면 안 됩니다.

 

구문

HRESULT WsGetMetadataEndpoints(
  [in]           WS_METADATA           *metadata,
  [out]          WS_METADATA_ENDPOINTS *endpoints,
  [in, optional] WS_ERROR              *error
);

매개 변수

[in] metadata

원하는 엔드포인트를 포함하는 메타데이터 개체에 대한 포인터입니다. 이 매개 변수는 유효한 WS_METADATA 개체여야 합니다.

[out] endpoints

성공하면 이 포인터 매개 변수는 메타데이터 개체에 정의된 엔드포인트에 대한 정보로 채워집니다.

[in, optional] error

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

반환 값

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

반환 코드	설명
E_INVALIDARG	이 개체에 대해 속성 ID가 지원되지 않았거나 지정된 버퍼가 값에 충분히 크지 않았습니다.
E_OUTOFMEMORY	메모리 리소스가 부족합니다.
기타 오류	이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

이 속성은 WS_METADATA_STATE_CREATED 또는 WS_METADATA_STATE_RESOLVED 상태에서 사용할 수 있습니다.

메타데이터 문서가 누락된 경우 이 함수는 실패합니다. WsGetMissingMetadataDocumentAddress를 사용하여 누락된 문서의 주소를 확인합니다.

요구 사항

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