CInternetSession::CInternetSession

CInternetSession (LPCTSTR pstrAgent = NULL, DWORD dwContext = 1, DWORD dwAccessType INTERNET_OPEN_TYPE_PRECONFIG, LPCTSTR = pstrProxyName = NULL, LPCTSTR pstrProxyBypass = NULL, DWORD dwFlags = 0);

매개 변수

pstrAgent

응용 프로그램 또는 인터넷 함수 (예를 들어, "Microsoft 인터넷 브라우저")를 호출 하는 엔터티의 이름을 식별 하는 문자열에 대 한 포인터입니다. PstrAgent NULL (기본값) 이면 프레임 워크 AfxGetAppName, 응용 프로그램의 이름을 포함 하는 null로 끝나는 문자열을 반환 하는 전역 함수를 호출 합니다. 일부 프로토콜 서버에 응용 프로그램을 식별 하려면이 문자열 사용。

dwContext

작업에 대 한 컨텍스트 식별자입니다. dwContext CInternetSession::OnStatusCallback에 의해 반환 되는 작업의 상태 정보를 식별 합니다. 기본값은 1로 설정 그러나, 작업에 대 한 특정 컨텍스트 ID를 명시적으로 지정할 수 있습니다. 개체와 그것이 작업 컨텍스트 id에 연결 됩니다. DwFlags INTERNET_FLAG_ASYNC를 포함 하는 경우 다음이 개체를 만든 개체는 비동기 동작 상태 콜백 루틴 등록으로. 동기적으로 완료 될 함수에서 dwContext 호출에 대 한 0으로 설정할 수 있다。

dwAccessType

필요한 액세스의 유형입니다. 다음은 유효한 값 중 하나가 정확 하 게 공급 될 수 있습니다.:

• INTERNET_OPEN_TYPE_PRECONFIGnbsp;??(레지스트리)에서 미리 구성 합니다. 이 액세스 유형은 기본으로 설정(&N)。
  
  
• INTERNET_OPEN_TYPE_DIRECTnbsp;??인터넷에 직접(&N)。
  
  
• INTERNET_OPEN_TYPE_PROXYnbsp;??CERN 프록시를 통해(&N)。

pstrProxyName

DwAccessType 을 INTERNET_OPEN_TYPE_PROXY로 설정 된 경우 기본 CERN 프록시 이름입니다. 기본값은 NULL 입니다.

pstrProxyBypass

선택적 서버 주소 목록을 포함 하는 문자열에 대 한 포인터입니다. 프록시 액세스를 사용할 때 이러한 주소를 무시할 수 있습니다. NULL 값을 제공 하는 경우 우회 목록은 레지스트리에서 읽을 것입니다. 이 매개 변수는 dwAccessType INTERNET_OPEN_TYPE_PROXY 로 설정 하는 경우에 의미。

dwFlags

와 같은 다양 한 옵션을 나타냅니다 캐싱 및 비동기 동작 합니다. 기본값은 0으로 설정 됩니다. 가능한 값은 다음과 같습니다.:

• INTERNET_FLAG_DONT_CACHEnbsp;??로컬로 또는 모든 게이트웨이 서버에서 데이터를 캐시 하지 않음(&N)。
  
  
• INTERNET_FLAG_ASYNCnbsp;??이 개체에 대 한 미래의 작업 ERROR_IO_PENDING실패할 수 있습니다. 작업이 완료 되 면 상태 콜백 INTERNET_STATUS_REQUEST_COMPLETE 와 함께 이루어집니다. 이 콜백은 원래 요청에 대 한 스레드가 아닌 다른 스레드에서 이다. EnableStatusCallback 설정 상태 콜백 루틴을 호출 해야 합니다 또는 함수 동기적으로 완료 될(&N)。
  
  
• INTERNET_FLAG_OFFLINEnbsp;??다운로드 작업만 영구 캐시를 통해 만족. 항목이 캐시에 존재 하지 않는 경우 적절 한 오류 코드가 반환 됩니다. 이 플래그를 비트 OR (&|) 연산자와 결합 될 수 있습니다.

주의

이 멤버 함수는 CInternetSession 개체를 만들 때 호출 됩니다. CInternetSession 는 응용 프로그램에서 호출 하는 첫 번째 인터넷 함수입니다. 내부 데이터 구조를 초기화 하 고 미래의 호출 응용 프로그램에 대 한 준비。

DwFlags INTERNET_FLAG_ASYNC를 포함 하는 경우 다음이 핸들에서 파생 된 모든 핸들 해야한다 비동기 동작 상태 콜백 루틴 등록으로。

인터넷 연결을 열 수 있습니다, CInternetSession AfxThrowInternetException throw。

CInternetSession 개요 |nbsp; 클래스 멤버 (ko) | 계층 구조 차트(&N)

참고 항목nbsp;CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext(&N)