InternetCreateUrlA 함수(wininet.h)

  • 아티클

구성 요소 부분에서 URL을 만듭니다.

구문

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

매개 변수

[in] lpUrlComponents

URL을 만들 구성 요소가 포함된 URL_COMPONENTS 구조체에 대한 포인터입니다.

[in] dwFlags

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

값 의미
ICU_ESCAPE
 모든 안전하지 않은 문자를 lpszUrlPath 멤버가 가리키는 경로 문자열의 해당 이스케이프 시퀀스로 변환하고 lpszExtraInfo에서 lpUrlComponents 매개 변수가 가리키는 URL_COMPONENTS 구조체의 멤버가 가리키는 추가 정보 문자열을 변환합니다.

InternetCreateUrl의 유니코드 버전은 먼저 시스템 코드 페이지를 사용하여 변환을 시도합니다. 실패하면 UTF-8로 돌아갑니다.
ICU_USERNAME
 사용되지 않음 - 무시됩니다.

[out] lpszUrl

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

[in, out] lpdwUrlLength

TCHAR에서 URL lpszUrl 버퍼의 크기를 지정하는 변수에 대한 포인터입니다. 함수가 반환되면 이 매개 변수는 NULL 종결자를 제외한 URL 문자열의 크기를 받습니다. GetLastError가 ERROR_INSUFFICIENT_BUFFER 반환하는 경우 이 매개 변수는 생성된 URL을 보유하는 데 필요한 바이트 수를 받습니다.

반환 값

함수가 성공하면 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

lpUrlComponents에 전달된 URL_COMPONENTS 구조체에서 스키마를 지정할 때 lpszScheme이 NULL이 아닌 경우 스키마에 사용됩니다. lpszScheme이 NULL인 경우 nScheme을 필요한 INTERNET_SCHEME 또는 INTERNET_SCHEME_DEFAULT 설정하여 INTERNET_SCHEME 열거형을 사용하여 체계를 지정할 수 있습니다.

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

참고

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

요구 사항

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

추가 정보

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

WinINet 함수