Kelas CGopherFileFind

Bantuan dalam pencarian file Internet dari server gopher.

Sintaks

class CGopherFileFind : public CFileFind

Anggota

Konstruktor Publik

Metode Publik

Keterangan

CGopherFileFind menyertakan fungsi anggota yang memulai pencarian, menemukan file, dan mengembalikan URL file.

Kelas MFC lainnya yang dirancang untuk Internet dan pencarian file lokal termasuk CFtpFileFind dan CFileFind. Bersama dengan CGopherFileFind, kelas-kelas ini menyediakan mekanisme yang mulus bagi pengguna untuk menemukan file tertentu, terlepas dari protokol server, jenis file, atau lokasi (baik komputer lokal atau server jarak jauh.) Perhatikan bahwa tidak ada kelas MFC untuk mencari di server HTTP karena HTTP tidak mendukung manipulasi file langsung yang diperlukan oleh pencarian.

• GetRoot

• GetFileName

• GetFilePath

• GetFileTitle

• GetFileURL

Selain itu, ketika digunakan dengan CGopherFileFind, CFileFind fungsi anggota IsDots selalu FALSE.

Untuk informasi selengkapnya tentang cara menggunakan CGopherFileFind dan kelas WinInet lainnya, lihat artikel Pemrograman Internet dengan WinInet.

Hierarki Warisan

CObject

CFileFind

CGopherFileFind

Persyaratan

Header: afxinet.h

CGopherFileFind::CGopherFileFind

Fungsi anggota ini dipanggil untuk membuat CGopherFileFind objek.

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

Parameter

pConnection
Penunjuk ke objek CGopherConnection .

dwContext
Pengidentifikasi konteks untuk operasi. Lihat Keterangan untuk informasi selengkapnya tentang dwContext.

Keterangan

Nilai default untuk dwContext dikirim oleh MFC ke CGopherFileFind objek dari objek CInternetSession yang membuat CGopherFileFind objek. Saat membuat CGopherFileFind objek, Anda dapat mengambil alih default untuk mengatur pengidentifikasi konteks ke nilai yang Anda pilih. Pengidentifikasi konteks dikembalikan ke CInternetSession::OnStatusCallback untuk memberikan status pada objek yang diidentifikasi. Lihat artikel Langkah Pertama Internet: WinInet untuk informasi selengkapnya tentang pengidentifikasi konteks.

CGopherFileFind::FindFile

Panggil fungsi anggota ini untuk menemukan file gopher.

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

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

Parameter

refLocator
Referensi ke objek CGopherLocator .

pstrString
Penunjuk ke string yang berisi nama file.

dwFlags
Bendera yang menjelaskan cara menangani sesi ini. Bendera yang valid adalah:

• INTERNET_FLAG_RELOAD Dapatkan data dari server jarak jauh meskipun di-cache secara lokal.

• INTERNET_FLAG_DONT_CACHE Jangan menyimpan data secara lokal atau di gateway apa pun.

• INTERNET_FLAG_SECURE Meminta transaksi aman pada kawat dengan Secure Sockets Layer atau PCT. Bendera ini hanya berlaku untuk permintaan HTTP.

• INTERNET_FLAG_USE_EXISTING Jika memungkinkan, gunakan kembali koneksi yang ada ke server untuk permintaan baru FindFile , alih-alih membuat sesi baru untuk setiap permintaan.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi Win32 GetLastError.

Keterangan

Setelah memanggil FindFile untuk mengambil objek gopher pertama, Anda dapat memanggil FindNextFile untuk mengambil file gopher berikutnya.

CGopherFileFind::FindNextFile

Panggil fungsi anggota ini untuk melanjutkan pencarian file dimulai dengan panggilan ke CGopherFileFind::FindFile.

virtual BOOL FindNextFile();

Tampilkan Nilai

Nonzero jika ada lebih banyak file; nol jika file yang ditemukan adalah yang terakhir dalam direktori atau jika terjadi kesalahan. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi Win32 GetLastError. Jika file yang ditemukan adalah file terakhir di direktori, atau jika tidak ada file yang cocok yang dapat ditemukan, GetLastError fungsi mengembalikan ERROR_NO_MORE_FILES.

CGopherFileFind::GetCreationTime

Mendapatkan waktu pembuatan untuk file saat ini.

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

Parameter

pTimeStamp
Penunjuk ke struktur FILETIME yang berisi waktu file dibuat.

refTime
Referensi ke objek CTime .

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak berhasil. GetCreationTime mengembalikan 0 hanya jika FindNextFile belum pernah dipanggil pada objek ini CGopherFileFind .

Keterangan

Anda harus memanggil FindNextFile setidaknya sekali sebelum memanggil GetCreationTime.

CGopherFileFind::GetLastAccessTime

Mendapatkan waktu file yang ditentukan terakhir kali diakses.

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

Parameter

refTime
Referensi ke objek CTime .

pTimeStamp
Penunjuk ke struktur FILETIME yang berisi waktu file terakhir diakses.

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak berhasil. GetLastAccessTime mengembalikan 0 hanya jika FindNextFile belum pernah dipanggil pada objek ini CGopherFileFind .

Keterangan

Anda harus memanggil FindNextFile setidaknya sekali sebelum memanggil GetLastAccessTime.

CGopherFileFind::GetLastWriteTime

Mendapatkan terakhir kali file diubah.

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

Parameter

pTimeStamp
Penunjuk ke struktur FILETIME yang berisi waktu file terakhir ditulis.

refTime
Referensi ke objek CTime .

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak berhasil. GetLastWriteTime mengembalikan 0 hanya jika FindNextFile belum pernah dipanggil pada objek ini CGopherFileFind .

Keterangan

Anda harus memanggil FindNextFile setidaknya sekali sebelum memanggil GetLastWriteTime.

CGopherFileFind::GetLength

Panggil fungsi anggota ini untuk mendapatkan panjang, dalam byte, dari file yang ditemukan.

virtual ULONGLONG GetLength() const;

Tampilkan Nilai

Panjangnya, dalam byte, dari file yang ditemukan.

Keterangan

GetLength menggunakan struktur Win32 WIN32_FIND_DATA untuk mendapatkan nilai ukuran file dalam byte.

Contoh

Lihat contoh untuk CFile::GetLength (implementasi kelas dasar).

CGopherFileFind::GetLocator

Panggil fungsi anggota ini untuk mendapatkan objek CGopherLocator yang digunakan FindFile untuk menemukan file gopher.

CGopherLocator GetLocator() const;

Tampilkan Nilai

Objek CGopherLocator.

CGopherFileFind::GetScreenName

Panggil fungsi anggota ini untuk mendapatkan nama layar gopher.

CString GetScreenName() const;

Tampilkan Nilai

Nama layar gopher.

CGopherFileFind::IsDots

Pengujian untuk penanda direktori dan direktori induk saat ini saat melakukan iterasi melalui file.

virtual BOOL IsDots() const;

Tampilkan Nilai

Bukan nol jika file yang ditemukan memiliki nama "." atau "..", yang menunjukkan bahwa file yang ditemukan sebenarnya adalah direktori. Jika tidak, 0.

Keterangan

Anda harus memanggil FindNextFile setidaknya sekali sebelum memanggil IsDots.

Lihat juga

Kelas CFileFind
Bagan Hierarki
Kelas CFtpFileFind
Kelas CFileFind
Kelas CInternetFile
Kelas CGopherFile
Kelas CHttpFile