다음을 통해 공유


CInternetConnection 클래스

인터넷 서버와의 연결을 관리합니다.

구문

class CInternetConnection : public CObject

멤버

공용 생성자

속성 설명
CInternet커넥트ion::CInternet커넥트ion CInternetConnection 개체를 생성합니다.

공용 메서드

이름 설명
CInternet커넥트ion::GetContext 이 연결 개체의 컨텍스트 ID를 가져옵니다.
CInternet커넥트ion::GetServerName 연결과 연결된 서버의 이름을 가져옵니다.
CInternet커넥트ion::GetSession 연결과 연결된 CInternetSession 개체에 대한 포인터를 가져옵니다.

Public 연산자

이름 설명
CInternet커넥트ion::operator HINTERNET 인터넷 세션에 대한 핸들입니다.

설명

MFC 클래스 CFtp커넥트ion, CHttp커넥트ionCGopher커넥트ion의 기본 클래스입니다. 이러한 각 클래스는 각 FTP, HTTP 또는 gopher 서버와 통신하기 위한 추가 기능을 제공합니다.

인터넷 서버와 직접 통신하려면 CInternetSession 개체와 개체가 CInternetConnection 있어야 합니다.

WinInet 클래스의 작동 방식에 대한 자세한 내용은 WinInet을 사용한 인터넷 프로그래밍 문서를 참조하세요.

상속 계층 구조

CObject

CInternetConnection

요구 사항

헤더: afxinet.h

CInternet커넥트ion::CInternet커넥트ion

이 멤버 함수는 개체를 CInternetConnection 만들 때 호출됩니다.

CInternetConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    DWORD_PTR dwContext = 1);

매개 변수

pSession
CInternetSession 개체에 대한 포인터입니다.

pstrServer
서버 이름을 포함하는 문자열에 대한 포인터입니다.

nPort
이 연결의 인터넷 포트를 식별하는 번호입니다.

dwContext
개체의 CInternetConnection 컨텍스트 식별자입니다. dwContext에 대한 자세한 내용은 비고를 참조하세요.

설명

자신을 호출 CInternetConnection 하지 않습니다. 대신 설정하려는 연결 유형에 대해 CInternetSession 멤버 함수를 호출합니다.

dwContext의 기본값은 MFCCInternetConnection에서 Internet커넥트ion 파생 개체를 만든 CInternetSession 개체에서 파생된 개체로 전송됩니다. 기본값은 1로 설정됩니다. 그러나 연결에 대한 CInternetSession 생성자에서 특정 컨텍스트 식별자를 명시적으로 할당할 수 있습니다. 개체와 개체가 수행하는 모든 작업은 해당 컨텍스트 ID와 연결됩니다. 컨텍스트 식별자는 CInternetSession::OnStatusCallback으로 반환되어 식별된 개체에 대한 상태 제공합니다. 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.

CInternet커넥트ion::GetContext

이 멤버 함수를 호출하여 이 세션의 컨텍스트 ID를 가져옵니다.

DWORD_PTR GetContext() const;

Return Value

애플리케이션 할당 컨텍스트 ID입니다.

설명

컨텍스트 ID는 원래 CInternetSession에서 지정되고 연결을 여는 함수 호출에서 다르게 지정되지 않는 한 CInternetFile 파생 클래스로 전파CInternetConnection됩니다. 컨텍스트 ID는 지정된 개체의 모든 작업과 연결되며 CInternetSession::OnStatusCallback에서 반환된 작업의 상태 정보를 식별합니다.

사용자에게 상태 정보를 제공하기 위해 다른 WinInet 클래스와 함께 작동하는 방법에 GetContext 대한 자세한 내용은 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.

CInternet커넥트ion::GetServerName

이 멤버 함수를 호출하여 이 인터넷 연결과 연결된 서버의 이름을 가져옵니다.

CString GetServerName() const;

Return Value

이 연결 개체가 작업 중인 서버의 이름입니다.

CInternet커넥트ion::GetSession

이 멤버 함수를 호출하여 이 연결과 연결된 개체에 CInternetSession 대한 포인터를 가져옵니다.

CInternetSession* GetSession() const;

Return Value

이 인터넷 연결 개체와 연결된 CInternetSession 개체에 대한 포인터입니다.

CInternet커넥트ion::operator HINTERNET

이 연산자를 사용하여 현재 인터넷 세션에 대한 API 수준 핸들을 가져옵니다.

operator HINTERNET() const;

참고 항목

CObject 클래스
계층 구조 차트