CGopherConnection 클래스

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

참고 항목

클래스CGopherConnection, CGopherFileCGopherFileFindCGopherLocator 및 해당 멤버는 Windows XP 플랫폼에서 작동하지 않으므로 더 이상 사용되지 않지만 이전 플랫폼에서 계속 작동합니다.

구문

class CGopherConnection : public CInternetConnection

멤버

공용 생성자

속성	설명
CGopherConnection::CGopherConnection	CGopherConnection 개체를 생성합니다.

공용 메서드

이름	설명
CGopherConnection::CreateLocator	고퍼 서버에서 파일을 찾는 CGopherLocator 개체를 만듭니다.
CGopherConnection::GetAttribute	gopher 개체에 대한 특성 정보를 검색합니다.
CGopherConnection::OpenFile	gopher 파일을 엽니다.

설명

gopher 서비스는 MFC WinInet 클래스에서 인식하는 세 가지 인터넷 서비스 중 하나입니다.

클래스 CGopherConnection 에는 생성자와 gopher 서비스를 관리하는 세 가지 추가 멤버 함수인 OpenFile, CreateLocator 및 GetAttribute가 포함됩니다.

고퍼 인터넷 서버와 통신하려면 먼저 CInternetSession 인스턴스를 만든 다음, 개체를 만들고 CGopherConnection 포인터를 반환하는 CInternetSession::GetGopherConnection을 호출해야 합니다. 개체를 CGopherConnection 직접 만들지 않습니다.

다른 MFC 인터넷 클래스의 작동 방식에 CGopherConnection 대한 자세한 내용은 WinInet을 사용한 인터넷 프로그래밍 문서를 참조하세요. 지원되는 다른 두 인터넷 서비스인 FTP 및 HTTP 사용에 대한 자세한 내용은 CHttpConnection 및 CFtpConnection 클래스를 참조하세요.

상속 계층 구조

CObject

CInternetConnection

CGopherConnection

요구 사항

헤더: afxinet.h

CGopherConnection::CGopherConnection

이 멤버 함수는 개체를 생성하기 위해 호출됩니다 CGopherConnection .

CGopherConnection(
    CInternetSession* pSession,
    HINTERNET hConnected,
    LPCTSTR pstrServer,
    DWORD_PTR dwContext);

CGopherConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    DWORD_PTR dwContext = 0,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

매개 변수

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

hConnected
현재 인터넷 세션의 Windows 핸들입니다.

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

dwContext
작업에 대한 컨텍스트 식별자입니다. dwContext는 CInternetSession::OnStatusCallback에서 반환된 작업의 상태 정보를 식별합니다. 기본값은 1로 설정되지만, 작업에 대한 특정 컨텍스트 ID를 명시적으로 할당할 수도 있습니다. 개체와 개체가 수행하는 모든 작업은 해당 컨텍스트 ID와 연결됩니다.

pstrUserName
로그인할 사용자의 이름을 지정하는, null로 끝나는 문자열에 대한 포인터입니다. NULL인 경우 기본값은 익명입니다.

pstrPassword
로그인하는 데 사용할 암호를 지정하는, null로 끝나는 문자열에 대한 포인터입니다. pstrPassword와 pstrUserName이 모두 NULL인 경우 기본 익명 암호는 사용자의 전자 메일 이름입니다. pstrPassword가 NULL(또는 빈 문자열)이지만 pstrUserName이 NULL이 아닌 경우 빈 암호가 사용됩니다. 다음 표에서는 pstrUserName 및 pstrPassword의 네 가지 가능한 설정에 대한 동작을 설명합니다.

pstrUserName	pstrPassword	사용자 이름을 FTP 서버로 전송	암호를 FTP 서버로 전송
NULL 또는 "	NULL 또는 "	"anonymous"	사용자의 이메일 이름
NULL이 아닌 문자열	NULL 또는 "	pstrUserName	" "
NULL 비 NULL 문자열	오류	오류
NULL이 아닌 문자열	NULL이 아닌 문자열	pstrUserName	pstrPassword

nPort
서버에서 사용할 TCP/IP 포트를 식별하는 숫자입니다.

설명

직접 만들 수 CGopherConnection 없습니다. 대신 개체를 만들고 CGopherConnection 포인터를 반환하는 CInternetSession::GetGopherConnection을 호출합니다.

CGopherConnection::CreateLocator

gopher 서버에서 파일을 찾거나 식별하는 gopher 로케이터를 만들려면 이 멤버 함수를 호출합니다.

CGopherLocator CreateLocator(
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType);

static CGopherLocator CreateLocator(LPCTSTR pstrLocator);

static CGopherLocator CreateLocator(
    LPCTSTR pstrServerName,
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

매개 변수

pstrDisplayString
검색할 gopher 문서 또는 디렉터리의 이름을 포함하는 문자열에 대한 포인터입니다. pstrDisplayString 매개 변수가 NULL이면 gopher 서버의 기본 디렉터리가 반환됩니다.

pstrSelectorString
항목을 검색하기 위해 gopher 서버로 보낼 선택기 문자열에 대한 포인터입니다. pstrSelectorString 은 NULL일 수 있습니다.

dwGopherType
pstrSelectorString이 디렉터리 또는 문서를 참조하는지 여부와 요청이 gopher 또는 gopher+인지 여부를 지정합니다. Windows SDK의 구조 GOPHER_FIND_DATA 특성을 참조하세요.

pstrLocator
열 파일을 식별하는 문자열에 대한 포인터입니다. 일반적으로 이 문자열은 CGopherFileFind::GetLocator 호출 에서 반환됩니다.

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

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

Return Value

CGopherLocator 개체입니다.

설명

정적 버전의 멤버 함수를 사용하려면 서버를 지정해야 하지만 비정적 버전은 연결 개체의 서버 이름을 사용합니다.

gopher 서버에서 정보를 검색하려면 애플리케이션이 먼저 gopher 로케이터를 가져와야 합니다. 그런 다음 애플리케이션은 로케이터를 불투명 토큰으로 처리해야 합니다(즉, 애플리케이션은 로케이터를 사용할 수 있지만 직접 조작하거나 비교할 수는 없음). 일반적으로 애플리케이션은 CGopherFileFind::FindFile 멤버 함수를 호출하기 위해 로케이터를 사용하여 특정 정보를 검색합니다.

CGopherConnection::GetAttribute

이 멤버 함수를 호출하여 gopher 서버에서 항목에 대한 특정 특성 정보를 검색합니다.

BOOL GetAttribute(
    CGopherLocator& refLocator    CString strRequestedAttributes,
    CString& strResult,);

매개 변수

refLocator
CGopherLocator 개체에 대한 참조입니다 .

strRequestedAttributes
요청된 특성의 이름을 지정하는 공백으로 구분된 문자열입니다.

strResult
로케이터 형식을 수신하는 CString 에 대한 참조입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.

CGopherConnection::OpenFile

이 멤버 함수를 호출하여 gopher 서버에서 파일을 엽니다.

CGopherFile* OpenFile(
    CGopherLocator& refLocator,
    DWORD dwFlags = 0,
    LPCTSTR pstrView = NULL,
    DWORD_PTR dwContext = 1);

매개 변수

refLocator
CGopherLocator 개체에 대한 참조입니다 .

dwFlags
INTERNET_FLAG_* 플래그의 조합입니다. INTERNET_FLAG_* 플래그에 대한 자세한 내용은 CInternetSession::OpenUrl을 참조하세요.

pstrView
파일 뷰 문자열에 대한 포인터입니다. 서버에 파일 보기가 여러 개 있는 경우 이 매개 변수는 열 파일 보기를 지정합니다. pstrView가 NULL이면 기본 파일 뷰가 사용됩니다.

dwContext
열려는 파일의 컨텍스트 ID입니다. dwContext에 대한 자세한 내용은 비고를 참조하세요.

Return Value

열 CGopherFile 개체에 대한 포인터입니다.

설명

dwContext 기본값을 재정의하여 컨텍스트 식별자를 선택한 값으로 설정합니다. 컨텍스트 식별자는 CInternetSession 개체에서 만든 개체의 CGopherConnection 이 특정 작업과 연결됩니다. 이 값은 CInternetSession::OnStatusCallback에 반환되어 식별된 작업에 대한 상태를 제공합니다. 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.

참고 항목

CInternetConnection 클래스
계층 구조 차트
CFtpConnection 클래스
CHttpConnection 클래스
CInternetConnection 클래스
CGopherLocator 클래스
CGopherFile 클래스
CInternetSession 클래스