UrlCanonicalizeA 함수(shlwapi.h)

아티클
11/20/2024

URL 문자열을 정식 형식으로 변환합니다.

통사론

LWSTDAPI UrlCanonicalizeA(
  [in]      PCSTR pszUrl,
  [out]     PSTR  pszCanonicalized,
  [in, out] DWORD *pcchCanonicalized,
            DWORD dwFlags
);

매개 변수

[in] pszUrl

형식: PCTSTR

URL 문자열을 포함하는 최대 길이 INTERNET_MAX_URL_LENGTH null로 끝나는 문자열에 대한 포인터입니다. 문자열이 파일을 참조하지 않는 경우 "http://"과 같은 유효한 체계를 포함해야 합니다.

[out] pszCanonicalized

형식: PTSTR

이 함수가 성공적으로 반환될 때 변환된 URL을 null로 종료된 문자열로 수신하는 버퍼에 대한 포인터입니다.

[in, out] pcchCanonicalized

형식: DWORD*

항목에서 pszCanonicalized 버퍼의 문자 수로 설정된 값에 대한 포인터입니다.

dwFlags

형식: DWORD

URL을 정식 형식으로 변환하는 방법을 지정하는 플래그입니다. 다음 플래그를 결합할 수 있습니다.

URL_UNESCAPE(0x10000000)

두 가지 예외를 제외하고 URL에 포함된 모든 이스케이프 시퀀스를 이스케이프 해제합니다. "?" 및 "#"의 이스케이프 시퀀스는 이스케이프되지 않습니다. URL_ESCAPE_XXX 플래그 중 하나가 설정되면 두 URL이 먼저 이스케이프 해제된 다음 결합된 다음 이스케이프됩니다.

URL_ESCAPE_UNSAFE(0x20000000)

안전하지 않은 문자를 이스케이프 시퀀스로 대체합니다. 안전하지 않은 문자는 인터넷을 통해 전송하는 동안 변경될 수 있는 문자이며 (<, >, ", #, {, }, |, , ^, [, ]및 ') 문자를 포함합니다. 이 플래그는 불투명 URL을 비롯한 모든 URL에 적용됩니다.

URL_PLUGGABLE_PROTOCOL(0x40000000)

W3C 사양에 따라 URL을 클라이언트 정의 플러그형 프로토콜과 결합합니다. 이 플래그는 ftp, http, gopher 등의 표준 프로토콜에는 적용되지 않습니다. 이 플래그가 설정되면 urlCombine URL을 간소화하지 않으므로 URL_DONT_SIMPLIFY설정할 필요가 없습니다.

URL_ESCAPE_SPACES_ONLY(0x04000000)

공백만 이스케이프 시퀀스로 대체합니다. 이 플래그는 URL_ESCAPE_UNSAFE우선하지만 불투명 URL에는 적용되지 않습니다.

URL_DONT_SIMPLIFY(0x08000000)

"/./" 및 "/.를 처리합니다. URL 문자열에서 탐색의 약식이 아닌 리터럴 문자로 입니다. 자세한 내용은 설명을 참조하세요.

URL_NO_META(0x08000000)

URL_DONT_SIMPLIFY같도록 정의됩니다.

URL_ESCAPE_PERCENT(0x00001000)

"%" 발생을 이스케이프 시퀀스로 변환합니다.

URL_ESCAPE_AS_UTF8(0x00040000)

Windows 7 이상. ASCII가 아닌 모든 문자를 UTF-8 등가물로 백분율로 인코딩합니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK반환됩니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

발언

이 함수는 안전하지 않은 문자를 이스케이프 시퀀스로 대체하고 "....."과 같은 시퀀스를 축소하는 등의 작업을 수행합니다.

URL 문자열에 "/.가 포함된 경우 /" 또는 "/./", UrlCanonicalize 문자를 URL 계층 구조의 탐색을 나타내는 것으로 처리합니다. 이 함수는 URL을 결합하기 전에 간소화합니다. 예를 들어 "/hello/cruel/.. /world"는 "/hello/world"로 간소화됩니다. 이 기본 동작에 대한 예외는 다음과 같은 경우에 발생합니다.

URL_DONT_SIMPLIFY 플래그가 dwFlags설정된 경우 함수는 URL을 간소화하지 않습니다. 이 경우 "/hello/cruel/.. /world"는 그대로 남아 있습니다.
"/.인 경우 /" 또는 "/./"는 경로의 첫 번째 세그먼트입니다(예: "http://domain/../path1/path2/file.htm"). UrlCanonicalize 입력된 것과 정확하게 경로를 출력합니다.

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 5.0 이상)

참고 항목

Uniform Resource Locators 처리

다음을 통해 공유