다음을 통해 공유


CInternetSession::CInternetSession

이 멤버 함수의 경우 호출 되는 CInternetSession 개체가 만들어집니다.

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

매개 변수

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

  • dwContext
    작업에 대 한 컨텍스트 식별자입니다.dwContext반환 되는 작업 상태 정보를 식별 합니다. CInternetSession::OnStatusCallback.기본값은 1로 설정 됩니다. 그러나 작업에 대 한 특정 컨텍스트 ID를 명시적으로 지정할 수 있습니다.개체 및 만약 잡을 해당 컨텍스트 ID에 연결 됩니다.

  • dwAccessType
    필요한 액세스 유형을 지정 합니다.다음 유효 값 중 하나가 제공입니다.

    • INTERNET_OPEN_TYPE_PRECONFIG 미리 구성 된 설정을 레지스트리를 사용 하 여 연결 합니다.이 액세스 형식은 기본값으로 설정 됩니다.TIS 프록시를 통해 연결을 설정 합니다. dwAccessType 값이 있습니다. 그런 다음 레지스트리를 적절 하 게 설정 합니다.

    • INTERNET_OPEN_TYPE_DIRECT인터넷에 직접 연결 합니다.

    • INTERNET_OPEN_TYPE_PROXYCERN 프록시를 통해 연결 합니다.

    프록시 형식과 연결에 대 한 내용은 단계를 일반적인 FTP 클라이언트 응용 프로그램에서.

  • pstrProxyName
    CERN 프록시 기본 설정된 이름을 경우 dwAccessType 로 설정 된 INTERNET_OPEN_TYPE_PROXY.기본값은 NULL.

  • pstrProxyBypass
    서버 주소 목록이 들어 있는 문자열에 대 한 포인터입니다.이 주소는 액세스 프록시를 사용 하는 경우 무시 될 수 있습니다.경우는 NULL 값이 제공 되어, 우회 목록 레지스트리에서 읽을 수 있습니다.이 매개 변수는 의미가 있습니다만 dwAccessType 설정 INTERNET_OPEN_TYPE_PROXY.

  • dwFlags
    다양 한 캐싱 옵션을 나타냅니다.기본값은 0으로 설정 됩니다.가능한 값은 다음과 같습니다.

    • INTERNET_FLAG_DONT_CACHE로컬로 또는 게이트웨이 서버에는 데이터를 캐시 하지 마십시오.

    • INTERNET_FLAG_OFFLINE다운로드 작업 영구적 캐시를 통해 유지 됩니다.항목이 캐시에 없으면 해당 오류 코드가 반환 됩니다.이 플래그의 비트와 함께 사용할 수 OR (|) 연산자.

설명

CInternetSession 첫 번째 인터넷 함수는 응용 프로그램에서 호출 됩니다.내부 데이터 구조를 초기화 하 고 향후 응용 프로그램 호출을 준비 합니다.

인터넷 연결을 열 수 있는 경우 CInternetSession throw 된 AfxThrowInternetException.

예제

예제를 보려면 CFtpFileFind.

요구 사항

헤더: afxinet.h

참고 항목

참조

CInternetSession 클래스

계층 구조 차트

CInternetSession::Close

CInternetSession::EnableStatusCallback

CInternetSession::GetContext