InternetOpenA 함수(wininet.h)
애플리케이션의 WinINet 함수 사용을 초기화합니다.
통사론
HINTERNET InternetOpenA(
[in] LPCSTR lpszAgent,
[in] DWORD dwAccessType,
[in] LPCSTR lpszProxy,
[in] LPCSTR lpszProxyBypass,
[in] DWORD dwFlags
);
매개 변수
[in] lpszAgent
WinINet 함수를 호출하는 애플리케이션 또는 엔터티의 이름을 지정하는 null종료된 문자열에 대한 포인터입니다. 이 이름은 HTTP 프로토콜에서 사용자 에이전트로 사용됩니다.
[in] dwAccessType
필요한 액세스 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
모든 호스트 이름을 로컬로 확인합니다. |
|
레지스트리에서 프록시 또는 직접 구성을 검색합니다. |
|
레지스트리에서 프록시 또는 직접 구성을 검색하고 시작 Microsoft JScript 또는 INS(인터넷 설정) 파일의 사용을 차단합니다. |
|
프록시 바이패스 목록을 제공하고 확인할 이름이 프록시를 무시하지 않는 한 프록시에 요청을 전달합니다. 이 경우 함수는 INTERNET_OPEN_TYPE_DIRECT사용합니다. |
[in] lpszProxy
dwAccessTypeINTERNET_OPEN_TYPE_PROXY설정하여 프록시 액세스를 지정할 때 사용할 프록시 서버의 이름을 지정하는 null종료 문자열에 대한 포인터입니다. internetOpen
[in] lpszProxyBypass
dwAccessTypeINTERNET_OPEN_TYPE_PROXY설정된 경우 프록시를 통해 라우팅되지 않아야 하는 호스트 이름 또는 IP 주소의 선택적 목록을 지정하는 null종료 문자열에 대한 포인터입니다. 목록에 와일드카드가 포함될 수 있습니다. internetOpen
기본적으로 WinINet은 호스트 이름 "localhost", "loopback", "127.0.0.1" 또는 "[::1]"을 사용하는 요청에 대해 프록시를 바이패스합니다. 이 동작은 일반적으로 원격 프록시 서버가 이러한 주소를 제대로 해결하지 못하기 때문에 존재합니다.Internet Explorer 9: "<-loopback>" 매크로를 사용하여 프록시 바이패스 목록에서 로컬 컴퓨터를 제거할 수 있습니다.
[in] dwFlags
옵션. 이 매개 변수는 다음 값의 조합일 수 있습니다.
값 | 의미 |
---|---|
|
이 함수에서 반환된 핸들에서 내림차순 핸들에 대한 비동기 요청만 수행합니다. |
|
네트워크 요청을 하지 않습니다. 모든 엔터티는 캐시에서 반환됩니다. 요청된 항목이 캐시에 없으면 ERROR_FILE_NOT_FOUND 같은 적절한 오류가 반환됩니다. |
|
INTERNET_FLAG_FROM_CACHE동일합니다. 네트워크 요청을 하지 않습니다. 모든 엔터티는 캐시에서 반환됩니다. 요청된 항목이 캐시에 없으면 ERROR_FILE_NOT_FOUND 같은 적절한 오류가 반환됩니다. |
반환 값
애플리케이션이 후속 WinINet 함수에 전달하는 유효한 핸들을 반환합니다. InternetOpen 실패하면 NULL반환됩니다. 특정 오류 메시지를 검색하려면 GetLastError호출합니다.
발언
InternetOpen 애플리케이션에서 호출하는 첫 번째 WinINet 함수입니다. 인터넷 DLL에 내부 데이터 구조를 초기화하고 애플리케이션에서 향후 호출을 준비하도록 지시합니다. 애플리케이션이 인터넷 함수 사용을 마치면 InternetCloseHandle 호출하여 핸들 및 연결된 리소스를 해제해야 합니다.
애플리케이션은 InternetOpen
호출 애플리케이션이 InternetOpen반환된 HINTERNET 핸들 사용을 완료한 후에는 InternetCloseHandle 함수를 사용하여 닫아야 합니다.
WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자 내에서 안전하게 호출할 수 없습니다.
메모
wininet.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 InternetOpen을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | wininet.h |
라이브러리 | 위니넷 lib |
DLL | Wininet.dll |
참고 항목
인터넷 기능 사용하도록 설정하는
winINet Functions