WsGetMissingMetadataDocumentAddress 함수(webservices.h)

  • 아티클

이 함수는 메타데이터 개체에서 참조하는 누락된 문서의 주소를 반환합니다.

메타데이터 개체에 추가된 각 문서에는 다른 문서에 대한 참조가 포함될 수 있습니다. 문서가 메타데이터에 다시 추가된 후 함수를 사용하여 누락된 다음 문서를 찾을 수 있습니다.

참고 반환되는 누락된 주소의 URL의 호스트 이름을 예상되는 호스트 이름 중 하나로 확인할 수 없는 경우 이 함수는 실패합니다. 예상된 호스트 이름은 다음과 같은 공용 구조체입니다.
 

구문

HRESULT WsGetMissingMetadataDocumentAddress(
  [in]           WS_METADATA         *metadata,
                 WS_ENDPOINT_ADDRESS **address,
  [in, optional] WS_ERROR            *error
);

매개 변수

[in] metadata

이 매개 변수는 문서가 있어야 하는 메타데이터 개체에 대한 포인터입니다.

address

성공하면 이 매개 변수는 누락된 메타데이터 문서의 주소에 대한 포인터로 채워지거나 누락된 메타데이터 문서가 없는 경우 NULL 로 채워집니다.

반환된 주소 URL은 정규화됩니다.

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

[in, optional] error

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

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

이 함수가 반환된 URL의 호스트 이름을 확인할지 여부는 WS_METADATA_PROPERTY_VERIFY_HOST_NAMES 열거자 값을 사용하여 제어할 수 있습니다.

호스트 이름 확인의 목적은 애플리케이션이 메타데이터를 수락하려는 호스트의 주소를 모르고 주소를 사용하지 않도록 하는 것입니다.

요구 사항

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