Share via

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의 다음 멤버 함수를 지원하지 않습니다.

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

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

상속 계층 구조

CObject

CFileFind

CGopherFileFind

요구 사항

헤더: afxinet.h

CGopherFileFind::CGopherFileFind

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

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

매개 변수

pConnection
CGopher커넥트ion 개체에 대한 포인터입니다.

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 클래스