CGopherFileFind 클래스

Gopher 서버의 인터넷 파일 검색에 유용합니다.

참고 항목

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

구문

class CGopherFileFind : public CFileFind

멤버

공용 생성자

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

공용 메서드

이름	설명
CGopherFileFind::FindFile	gopher 서버에서 파일을 찾습니다.
CGopherFileFind::FindNextFile	FindFile에 대한 이전 호출에서 파일 검색을 계속합니다.
CGopherFileFind::GetCreationTime	지정한 파일을 만든 시간을 가져옵니다.
CGopherFileFind::GetLastAccessTime	지정된 파일에 마지막으로 액세스한 시간을 가져옵니다.
CGopherFileFind::GetLastWriteTime	지정한 파일을 마지막으로 쓴 시간을 가져옵니다.
CGopherFileFind::GetLength	찾은 파일의 길이(바이트)를 가져옵니다.
CGopherFileFind::GetLocator	개체를 CGopherLocator 가져옵니다.
CGopherFileFind::GetScreenName	gopher 화면의 이름을 가져옵니다.
CGopherFileFind::IsDots	파일을 반복하는 동안 현재 디렉터리 및 부모 디렉터리 마커를 테스트합니다.

설명

CGopherFileFind 에는 검색을 시작하고, 파일을 찾고, 파일의 URL을 반환하는 멤버 함수가 포함되어 있습니다.

검색된 인터넷 및 로컬 파일을 위해 설계된 다른 MFC 클래스에는 CFtpFileFind 및 CFileFind가 포함됩니다. 이러한 클래스는 CGopherFileFind서버 프로토콜, 파일 형식 또는 위치(로컬 컴퓨터 또는 원격 서버)에 관계없이 사용자가 특정 파일을 찾을 수 있는 원활한 메커니즘을 제공합니다. HTTP는 검색에 필요한 직접 파일 조작을 지원하지 않으므로 HTTP 서버에서 검색할 MFC 클래스가 없습니다.

참고 항목

CGopherFileFind 에서는 기본 클래스 CFileFind의 다음 멤버 함수를 지원하지 않습니다.

• GetRoot

• GetFileName

• GetFilePath

• GetFileTitle

• GetFileURL

또한 함께 CGopherFileFindCFileFind 사용할 경우 멤버 함수 IsDots는 항상 FALSE입니다.

사용 CGopherFileFind 방법 및 다른 WinInet 클래스에 대한 자세한 내용은 WinInet을 사용한 인터넷 프로그래밍 문서를 참조하세요.

상속 계층 구조

CObject

CFileFind

CGopherFileFind

요구 사항

헤더: afxinet.h

CGopherFileFind::CGopherFileFind

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

explicit CGopherFileFind(
    CGopherConnection* pConnection,
    DWORD_PTR dwContext = 1);

매개 변수

pConnection
CGopherConnection 개체에 대한 포인터입니다.

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

설명

dwContext의 기본값은 MFC에서 개체를 CGopherFileFind 만든 CGopherFileFind CInternetSession 개체의 개체로 전송됩니다. 개체를 생성할 때 기본값을 CGopherFileFind 재정의하여 컨텍스트 식별자를 선택한 값으로 설정할 수 있습니다. 컨텍스트 식별자는 CInternetSession::OnStatusCallback으로 반환되어 식별된 개체의 상태를 제공합니다. 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.

CGopherFileFind::FindFile

이 멤버 함수를 호출하여 gopher 파일을 찾습니다.

virtual BOOL FindFile(
    CGopherLocator& refLocator,
    LPCTSTR pstrString,
    DWORD dwFlags = INTERNET_FLAG_RELOAD);

virtual BOOL FindFile(
    LPCTSTR pstrString,
    DWORD dwFlags = INTERNET_FLAG_RELOAD);

매개 변수

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

pstrString
파일 이름을 포함하는 문자열에 대한 포인터입니다.

dwFlags
이 세션을 처리하는 방법을 설명하는 플래그입니다. 유효한 플래그는 다음과 같습니다.

• INTERNET_FLAG_RELOAD 로컬로 캐시된 경우에도 원격 서버에서 데이터를 가져옵니다.

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

• INTERNET_FLAG_SECURE Secure Sockets Layer 또는 PCT를 사용하여 유선에서 보안 트랜잭션을 요청합니다. 이 플래그는 HTTP 요청에만 적용됩니다.

• INTERNET_FLAG_USE_EXISTING 가능하면 각 요청에 대한 새 세션을 만드는 대신 서버에 대한 기존 연결을 새 FindFile 요청에 다시 사용합니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다. 확장 오류 정보를 얻으려면 Win32 함수 GetLastError를 호출합니다.

설명

첫 번째 gopher 개체를 검색하기 위해 호출 FindFile 한 후 FindNextFile을 호출하여 후속 gopher 파일을 검색할 수 있습니다.

CGopherFileFind::FindNextFile

CGopherFileFind::FindFile을 호출하여 시작된 파일 검색을 계속하려면 이 멤버 함수를 호출합니다.

virtual BOOL FindNextFile();

Return Value

파일이 더 있는 경우 0이 아닌 경우 파일이 디렉터리의 마지막 파일이거나 오류가 발생한 경우 0입니다. 확장 오류 정보를 얻으려면 Win32 함수 GetLastError를 호출합니다. 찾은 파일이 디렉터리의 마지막 파일이거나 일치하는 파일을 찾을 수 없는 경우 함수는 GetLastError ERROR_NO_MORE_FILES 반환합니다.

CGopherFileFind::GetCreationTime

현재 파일의 생성 시간을 가져옵니다.

virtual BOOL GetCreationTime(FILETIME* pTimeStamp) const;
virtual BOOL GetCreationTime(CTime& refTime) const;

매개 변수

pTimeStamp
파일이 만들어진 시간을 포함하는 FILETIME 구조체에 대한 포인터입니다.

refTime
CTime 개체에 대한 참조입니다.

Return Value

성공하면 0이 아닌 값입니다. 실패하면 0입니다. GetCreationTime는 FindNextFile이 이 CGopherFileFind 개체에 대해 호출된 적이 없는 경우에만 0을 반환합니다.

설명

호출 하기 전에 FindNextFile 을 한 번 이상 호출 GetCreationTime해야 합니다.

참고 항목

모든 파일 시스템에서 동일한 의미 체계를 사용하여 이 함수에서 반환하는 타임스탬프를 구현하는 것은 아닙니다. 기본 파일 시스템 또는 서버가 시간 특성 유지를 지원하지 않는 경우 이 함수는 다른 타임스탬프를 통해 반환된 동일한 값을 반환할 수 있습니다. 시간 형식에 대한 자세한 내용은 WIN32_FIND_DATA 구조를 참조하세요. 일부 운영 체제에서 반환된 시간은 파일이 있는 컴퓨터의 로컬 표준 시간대에 있습니다. 자세한 내용은 Win32 FileTimeToLocalFileTime API를 참조하세요.

CGopherFileFind::GetLastAccessTime

지정된 파일에 마지막으로 액세스한 시간을 가져옵니다.

virtual BOOL GetLastAccessTime(CTime& refTime) const;
virtual BOOL GetLastAccessTime(FILETIME* pTimeStamp) const;

매개 변수

refTime
CTime 개체에 대한 참조입니다.

pTimeStamp
파일에 마지막으로 액세스한 시간을 포함하는 FILETIME 구조체에 대한 포인터입니다.

Return Value

성공하면 0이 아닌 값입니다. 실패하면 0입니다. GetLastAccessTime는 FindNextFile이 이 CGopherFileFind 개체에 대해 호출된 적이 없는 경우에만 0을 반환합니다.

설명

호출 하기 전에 FindNextFile 을 한 번 이상 호출 GetLastAccessTime해야 합니다.

참고 항목

모든 파일 시스템에서 동일한 의미 체계를 사용하여 이 함수에서 반환하는 타임스탬프를 구현하는 것은 아닙니다. 기본 파일 시스템 또는 서버가 시간 특성 유지를 지원하지 않는 경우 이 함수는 다른 타임스탬프를 통해 반환된 동일한 값을 반환할 수 있습니다. 시간 형식에 대한 자세한 내용은 WIN32_FIND_DATA 구조를 참조하세요. 일부 운영 체제에서 반환된 시간은 파일이 있는 컴퓨터의 로컬 표준 시간대에 있습니다. 자세한 내용은 Win32 FileTimeToLocalFileTime API를 참조하세요.

CGopherFileFind::GetLastWriteTime

파일이 마지막으로 변경된 시간을 가져옵니다.

virtual BOOL GetLastWriteTime(FILETIME* pTimeStamp) const;
virtual BOOL GetLastWriteTime(CTime& refTime) const;

매개 변수

pTimeStamp
파일이 마지막으로 기록된 시간을 포함하는 FILETIME 구조체에 대한 포인터입니다.

refTime
CTime 개체에 대한 참조입니다.

Return Value

성공하면 0이 아닌 값입니다. 실패하면 0입니다. GetLastWriteTime는 FindNextFile이 이 CGopherFileFind 개체에 대해 호출된 적이 없는 경우에만 0을 반환합니다.

설명

호출 하기 전에 FindNextFile 을 한 번 이상 호출 GetLastWriteTime해야 합니다.

참고 항목

모든 파일 시스템에서 동일한 의미 체계를 사용하여 이 함수에서 반환하는 타임스탬프를 구현하는 것은 아닙니다. 기본 파일 시스템 또는 서버가 시간 특성 유지를 지원하지 않는 경우 이 함수는 다른 타임스탬프를 통해 반환된 동일한 값을 반환할 수 있습니다. 시간 형식에 대한 자세한 내용은 WIN32_FIND_DATA 구조를 참조하세요. 일부 운영 체제에서 반환된 시간은 파일이 있는 컴퓨터의 로컬 표준 시간대에 있습니다. 자세한 내용은 Win32 FileTimeToLocalFileTime API를 참조하세요.

CGopherFileFind::GetLength

이 멤버 함수를 호출하여 찾은 파일의 길이(바이트)를 가져옵니다.

virtual ULONGLONG GetLength() const;

Return Value

찾은 파일의 길이(바이트)입니다.

설명

GetLength 에서는 Win32 구조 체 WIN32_FIND_DATA 사용하여 파일 크기의 값을 바이트 단위로 가져옵니다.

참고 항목

MFC 7.0 GetLength 을 기준으로 64비트 정수 형식을 지원합니다. 이 최신 버전의 라이브러리로 빌드된 기존 코드는 잘림 경고가 발생할 수 있습니다.

예시

CFile::GetLength(기본 클래스 구현)에 대한 예제를 참조하세요.

CGopherFileFind::GetLocator

FindFile에서 gopher 파일을 찾는 데 사용하는 CGopherLocator 개체를 얻으려면 이 멤버 함수를 호출합니다.

CGopherLocator GetLocator() const;

Return Value

CGopherLocator 개체입니다.

CGopherFileFind::GetScreenName

이 멤버 함수를 호출하여 gopher 화면의 이름을 가져옵니다.

CString GetScreenName() const;

Return Value

gopher 화면의 이름입니다.

CGopherFileFind::IsDots

파일을 반복하는 동안 현재 디렉터리 및 부모 디렉터리 마커를 테스트합니다.

virtual BOOL IsDots() const;

Return Value

찾은 파일에 이름이 "." 또는 ".."이면 0이 아니고, 이는 찾은 파일이 실제로 디렉터리임을 나타냅니다. 그렇지 않으면 0입니다.

설명

호출 하기 전에 FindNextFile 을 한 번 이상 호출 IsDots해야 합니다.

참고 항목

CFileFind 클래스
계층 구조 차트
CFtpFileFind 클래스
CFileFind 클래스
CInternetFile 클래스
CGopherFile 클래스
CHttpFile 클래스