다음을 통해 공유

WsDecodeUrl 함수(webservices.h)

  • 아티클

URL의 구성 요소를 평가하여 해당 "체계"를 확인합니다. WS_URL_SCHEME_TYPE 값은 WS_URL 구조체에 캡슐화되고 구조체에 대한 참조는 출력 매개 변수를 통해 반환됩니다. 스키마가 인식되지 않으면 함수는 WS_E_INVALID_FORMAT 반환합니다.
WS_URL_SCHEME_TYPE 식별된 체계 유형만 지원됩니다.

구문

HRESULT WsDecodeUrl(
  [in]           const WS_STRING *url,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
                 WS_URL          **outUrl,
  [in, optional] WS_ERROR        *error
);

매개 변수

[in] url

평가할 URL의 WS_STRING 표현에 대한 포인터입니다.

[in] flags

URL 체계 평가 방법을 결정합니다. WS_URL_FLAGS 참조하세요.

[in] heap

반환된 URL 참조를 할당할 WS_HEAP 대한 포인터입니다.

outUrl

WS_URL_SCHEME_TYPE 값을 캡슐화하는 WS_URL 구조체에 대한 참조입니다.

[in, optional] error

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

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
WS_E_INVALID_FORMAT
 입력 URL이 올바른 형식이 아니거나 스키마가 인식되지 않았습니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

"http", "https", "net.tcp" 및 "soap.udp" 체계에 대해 구문 분석된 문법은 에서 http://www.ietf.org/rfc/rfc3986.txt찾을 수 있습니다. 이러한 스키마의 경우:

  • 비어 있지 않은 호스트 이름이 필요합니다.
  • IP 리터럴 프로덕션의 경우 "[" 및 "]"로 구분된 모든 문자가 반환됩니다. IPv6Address 프로덕션을 따르도록 적용되지 않습니다.
  • 권한의 userinfo 부분(예: userinfo@hostname:port)은 지원되지 않습니다.

포트가 지정되지 않은 경우 해당 스키마의 기본 포트가 반환됩니다.

soap.udp 스키마에 대해 지정된 포트가 없는 경우 0xFFFFFFFF 기본값으로 반환됩니다.

요구 사항

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