UrlFixupW 함수(shlwapi.h)

[UrlFixupW 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 사용할 수 없습니다.]

프로토콜 식별자가 잘못된 URL을 수정하려고 시도합니다. 예를 들어 . htttphttp

Syntax

LWSTDAPI UrlFixupW(
  [in]  PCWSTR pcszUrl,
  [out] PWSTR  pszTranslatedUrl,
        DWORD  cchMax
);

매개 변수

[in] pcszUrl

형식: PCWSTR

수정할 URL을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 문자열은 종결 NULL 문자를 포함하여 길이가 INTERNET_MAX_PATH_LENGTH 문자를 초과해서는 안됩니다.

[out] pszTranslatedUrl

형식: PWSTR

이 함수가 성공적으로 반환될 때 복사된 문자를 받는 버퍼에 대한 포인터입니다. 버퍼는 종료 NULL 문자를 포함하여 cchMax 매개 변수에 지정된 WCHAR 문자 수를 포함할 만큼 커야 합니다. 이 매개 변수는 PCszUrl 매개 변수와 같아서 URL을 수정할 수 있습니다. pszTranslatedUrl이 pcszUrl과 같지 않으면 pszTranslatedUrl이 가리키는 버퍼가 pcszUrl이 가리키는 버퍼와 겹치지 않아야 합니다.

cchMax

형식: DWORD

pszTranslatedUrl이 가리키는 버퍼에 포함될 수 있는 WCHAR 문자 수입니다. 이 매개 변수는 0보다 커야 합니다.

반환 값

형식: HRESULT

제안된 URL이 이미 허용되었거나 성공적으로 수정된 경우 S_OK 반환합니다. pszTranslatedUrl 버퍼에는 수정된 URL 또는 수정이 필요하지 않은 경우 원래 URL이 포함됩니다. 제안된 URL을 충분히 인식할 수 없으면 S_FALSE 반환합니다. 그렇지 않으면 표준 COM 오류 코드를 반환합니다.

비고

UrlFixup 함수는 URL_SCHEME 열거형에 지정된 체계를 인식합니다.

프로토콜 식별자 섹션의 첫 번째 문자에 우선 순위가 지정되므로 htp 대신로 httpftp변환됩니다.

예시

이 예제에서는 UrlFixupW를 사용하는 방법을 보여 줍니다. 마지막 4개의 자동 고침은 사용자가 의도한 것이 아니었으며 함수에서 사용하는 추론의 제한 사항을 보여 줍니다.

#include <windows.h>
#include <shlwapi.h>
#include <stdio.h>
#include <tchar.h>

void sample(LPCWSTR pszUrl)
{
    WCHAR szBuf[256];
    
    HRESULT hr = UrlFixupW(pszUrl, szBuf, 256);
    if (hr == S_OK) 
    {
        wprintf(L"%-35s %s\n", pszUrl, szBuf);
    } 
    else 
    {
        wprintf(L"%-35s failed\n", pszUrl);
    }
}

int __cdecl main()
{
    sample(L"http://www.microsoft.com");
    sample(L"mail:someone@example.com");
    sample(L"abc:def");
    sample(L"someone@example.com");
    sample(L"htpp:wwwmicrosoft.com");
    sample(L"htps:\\\\www.microsoft.com");
    sample(L"http:someone@example.com");

    return 0;
}

..................................

This example might produce the following output:

http://www.microsoft.com    http://www.microsoft.com
http:www.microsoft.com      http://www.microsoft.com
mail:someone@example.com    mailto:someone@example.com
abc:def                     failed
someone@example.com         failed
htpp:wwwmicrosoft.com       http://wwwmicrosoft.com
htps:\\www.microsoft.com    http://www.microsoft.com
http:someone@example.com    http://someone@example.com
                

요구 사항