다음을 통해 공유

InternetCombineUrlW 함수(wininet.h)

  • 아티클

기본 및 상대 URL을 단일 URL로 결합합니다. 결과 URL은 정식화됩니다( InternetCanonicalizeUrl 참조).

구문

BOOL InternetCombineUrlW(
  [in]      LPCWSTR lpszBaseUrl,
  [in]      LPCWSTR lpszRelativeUrl,
  [out]     LPWSTR  lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength,
  [in]      DWORD   dwFlags
);

매개 변수

[in] lpszBaseUrl

기본 URL을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] lpszRelativeUrl

상대 URL을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[out] lpszBuffer

결합된 URL을 수신하는 버퍼에 대한 포인터입니다.

[in, out] lpdwBufferLength

lpszBuffer 버퍼의 크기를 문자 단위로 포함하는 변수에 대한 포인터입니다. 함수가 성공하면 이 매개 변수는 null 종료 문자를 포함하지 않고 결합된 URL의 크기를 문자로 받습니다. 함수가 실패하면 이 매개 변수는 필요한 버퍼의 크기를 문자(null 종료 문자 포함)로 받습니다.

[in] dwFlags

함수의 작업을 제어합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
ICU_BROWSER_MODE
 "#" 또는 "?" 뒤에 있는 문자를 인코딩하거나 디코딩하지 않으며 "?" 뒤에 오는 공백을 제거하지 않습니다. 이 값을 지정하지 않으면 전체 URL이 인코딩되고 후행 공백이 제거됩니다.
ICU_DECODE
 URL을 구문 분석하기 전에 모든 %XX 시퀀스를 이스케이프 시퀀스를 포함한 문자로 변환합니다.
ICU_ENCODE_PERCENT
 발견된 백분율 기호를 인코딩합니다. 기본적으로 백분율 기호는 인코딩되지 않습니다. 이 값은 Microsoft Internet Explorer 5 이상에서 사용할 수 있습니다.
ICU_ENCODE_SPACES_ONLY
 공백만 인코딩합니다.
ICU_NO_ENCODE
 안전하지 않은 문자를 이스케이프 시퀀스로 변환하지 않습니다.
ICU_NO_META
 URL에서 메타 시퀀스(예: "." 및 "..")를 제거하지 않습니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 가능한 오류에는 다음이 포함됩니다.

반환 코드 설명
ERROR_BAD_PATHNAME
 URL을 결합할 수 없습니다.
ERROR_INSUFFICIENT_BUFFER
 함수에 제공된 버퍼가 부족하거나 NULL이 아니었습니다. lpdwBufferLength 매개 변수로 표시된 값에는 결합된 URL을 보유하는 데 필요한 바이트 수가 포함됩니다.
ERROR_INTERNET_INVALID_URL
 URL 형식이 잘못되었습니다.
ERROR_INVALID_PARAMETER
 잘못된 문자열, 버퍼, 버퍼 크기 또는 flags 매개 변수가 있습니다.

설명

참고 WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하지 않아야 합니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.
 

참고

wininet.h 헤더는 INTERNETCombineUrl을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wininet.h
라이브러리 Wininet.lib
DLL Wininet.dll

추가 정보

균일한 리소스 로케이터 처리

WinINet 함수