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
이 함수의 작업을 제어합니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
모든 안전하지 않은 문자를 lpszUrlPath 멤버가 가리키는 경로 문자열의 해당 이스케이프 시퀀스로 변환하고 lpszExtraInfo에서 lpUrlComponents 매개 변수가 가리키는 URL_COMPONENTS 구조체의 멤버가 가리키는 추가 정보 문자열을 변환합니다.
InternetCreateUrl의 유니코드 버전은 먼저 시스템 코드 페이지를 사용하여 변환을 시도합니다. 실패하면 UTF-8로 돌아갑니다. |
|
사용되지 않음 - 무시됩니다. |
[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.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 InternetCreateUrl을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wininet.h |
| 라이브러리 | Wininet.lib |
| DLL | Wininet.dll |