WsEncodeUrl 함수(webservices.h)

  • 아티클

지정된 WS_URL 구성 요소 부분에 따라 URL 문자열로 인코딩합니다. 값은 필요에 따라 이스케이프되고, 결합되고, 지정된 WS_HEAP 저장되며 결과는 WS_STRING 반환됩니다.

구문

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

매개 변수

[in] url

인코딩할 WS_URL 대한 참조입니다.

[in] flags

이 매개 변수의 값은 URL 체계 평가 방법을 결정합니다. WS_URL_FLAGS 참조하세요.

[in] heap

URL을 할당할 WS_HEAP 대한 포인터입니다.

[out] outUrl

결과 URL 문자열에 대한 포인터입니다.

[in, optional] error

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

반환 값

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

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

설명

url 매개 변수에서 스키마가 인식되지 않으면 함수는 WS_E_INVALID_FORMAT 반환합니다.
WS_URL_SCHEME_TYPE 식별된 체계 유형만 지원됩니다.

요구 사항

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