CGopherFileFind Sınıfı

Gopher sunucularının İnternet dosya aramalarına yardımcı olur.

Not

CGopherConnection, , CGopherFileCGopherFileFindCGopherLocator ve üyeleri, Windows XP platformunda çalışmadıkları için kullanımdan kaldırılmıştır, ancak önceki platformlarda çalışmaya devam ederler.

Sözdizimi

class CGopherFileFind : public CFileFind

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CGopherFileFind::CGopherFileFind	Bir CGopherFileFind nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CGopherFileFind::FindFile	Gopher sunucusunda bir dosya bulur.
CGopherFileFind::FindNextFile	Önceki bir FindFile çağrısından dosya aramasına devam eder.
CGopherFileFind::GetCreationTime	Belirtilen dosyanın oluşturulduğu zamanı alır.
CGopherFileFind::GetLastAccessTime	Belirtilen dosyaya en son erişildiği zamanı alır.
CGopherFileFind::GetLastWriteTime	Belirtilen dosyanın son yazıldığı zamanı alır.
CGopherFileFind::GetLength	Bulunan dosyanın uzunluğunu bayt cinsinden alır.
CGopherFileFind::GetLocator	Bir CGopherLocator nesne alın.
CGopherFileFind::GetScreenName	Gopher ekranının adını alır.
CGopherFileFind::IsDots	Dosyalar arasında yineleme yaparken geçerli dizin ve üst dizin işaretçilerini test eder.

Açıklamalar

CGopherFileFind , bir arama başlatan, bir dosyayı bulup dosyanın URL'sini döndüren üye işlevleri içerir.

İnternet ve arama yapılan yerel dosya için tasarlanan diğer MFC sınıfları arasında CFtpFileFind ve CFileFind bulunur. ile CGopherFileFindbirlikte, bu sınıflar sunucu protokolüne, dosya türüne veya konuma (yerel makine veya uzak sunucu) bakılmaksızın kullanıcının belirli dosyaları bulması için sorunsuz bir mekanizma sağlar. HTTP, aramalar için gereken doğrudan dosya işlemeyi desteklemediğinden HTTP sunucularında arama için MFC sınıfı olmadığını unutmayın.

Not

CGopherFileFind, CFileFind temel sınıfının aşağıdaki üye işlevlerini desteklemez:

• GetRoot

• GetFileName

• GetFilePath

• GetFileTitle

• GetFileURL

Ayrıca, ile CGopherFileFindCFileFind kullanıldığında IsDots üye işlevi her zaman YANLIŞ'tır.

Ve diğer WinInet sınıflarını kullanma CGopherFileFind hakkında daha fazla bilgi için WinInet ile İnternet Programlama makalesine bakın.

Devralma Hiyerarşisi

CObject

CFileFind

CGopherFileFind

Gereksinimler

Üst bilgi: afxinet.h

CGopherFileFind::CGopherFileFind

Bu üye işlevi bir CGopherFileFind nesne oluşturmak için çağrılır.

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

Parametreler

pConnection
CGopherConnection nesnesinin işaretçisi .

dwContext
İşlemin bağlam tanımlayıcısı. dwContext hakkında daha fazla bilgi için bkz. Açıklamalar.

Açıklamalar

dwContext için varsayılan değer MFC CGopherFileFind tarafından nesneyi oluşturan CInternetSession nesnesinden nesneye CGopherFileFind gönderilir. Bir CGopherFileFind nesne oluşturduğunuzda, bağlam tanımlayıcısını seçtiğiniz bir değere ayarlamak için varsayılanı geçersiz kılabilirsiniz. Bağlam tanımlayıcısı, tanımlandığı nesnede durum sağlamak için CInternetSession::OnStatusCallback'e döndürülür. Bağlam tanımlayıcısı hakkında daha fazla bilgi için İnternet İlk Adımlar: WinInet makalesine bakın.

CGopherFileFind::FindFile

Gopher dosyasını bulmak için bu üye işlevini çağır.

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

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

Parametreler

refLocator
CGopherLocator nesnesine başvuru.

pstrString
Dosya adını içeren bir dize işaretçisi.

dwFlags
Bu oturumun nasıl işleneceğini açıklayan bayraklar. Geçerli bayraklar şunlardır:

• INTERNET_FLAG_RELOAD Verileri yerel olarak önbelleğe alınmış olsa bile uzak sunucudan alın.

• INTERNET_FLAG_DONT_CACHE Verileri yerel olarak veya herhangi bir ağ geçidinde önbelleğe alma.

• INTERNET_FLAG_SECURE Güvenli Yuva Katmanı veya PCT ile kablo üzerinde güvenli işlemler isteyin. Bu bayrak yalnızca HTTP istekleri için geçerlidir.

• INTERNET_FLAG_USE_EXISTING Mümkünse, her istek için yeni FindFile bir oturum oluşturmak yerine yeni istekler için sunucuya yönelik mevcut bağlantıları yeniden kullanın.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0. Genişletilmiş hata bilgilerini almak için Win32 işlevini GetLastError olarak çağırın.

Açıklamalar

İlk gopher nesnesini almak için çağrısı FindFile yaptıktan sonra, sonraki gopher dosyalarını almak için FindNextFile'ı çağırabilirsiniz.

CGopherFileFind::FindNextFile

CGopherFileFind::FindFile çağrısıyla başlayan bir dosya aramasına devam etmek için bu üye işlevini çağır.

virtual BOOL FindNextFile();

Dönüş Değeri

Daha fazla dosya varsa sıfır olmayan; dizinindeki son dosyaysa veya bir hata oluştuysa sıfır. Genişletilmiş hata bilgilerini almak için Win32 işlevini GetLastError olarak çağırın. Bulunan dosya dizindeki son dosyaysa veya eşleşen dosya bulunamıyorsa işlev GetLastError ERROR_NO_MORE_FILES döndürür.

CGopherFileFind::GetCreationTime

Geçerli dosyanın oluşturma zamanını alır.

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

Parametreler

pTimeStamp
Dosyanın oluşturulduğu saati içeren FILETIME yapısının işaretçisi.

refTime
CTime nesnesine başvuru.

Dönüş Değeri

Başarılı olursa sıfır olmayan; Başarısız olursa 0. GetCreationTimeyalnızca Bu CGopherFileFind nesnede FindNextFile hiç çağrılmadıysa 0 döndürür.

Açıklamalar

çağırmadan önce FindNextFile'ı en az bir kez çağırmanız GetCreationTimegerekir.

Not

Bu işlev tarafından döndürülen zaman damgasını uygulamak için tüm dosya sistemleri aynı semantiği kullanmaz. Temel alınan dosya sistemi veya sunucu time özniteliğinin tutulmasını desteklemiyorsa, bu işlev diğer zaman damgası işlevleri tarafından döndürülen değeri döndürebilir. Zaman biçimleri hakkında bilgi için WIN32_FIND_DATA yapısına bakın. Bazı işletim sistemlerinde döndürülen saat, dosyanın bulunduğu makinenin yerel saat dilimindedir. Daha fazla bilgi için win32 FileTimeToLocalFileTime API'sine bakın.

CGopherFileFind::GetLastAccessTime

Belirtilen dosyaya en son erişildiği zamanı alır.

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

Parametreler

refTime
CTime nesnesine başvuru.

pTimeStamp
Dosyaya en son erişildiği saati içeren FILETIME yapısının işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; Başarısız olursa 0. GetLastAccessTimeyalnızca Bu CGopherFileFind nesnede FindNextFile hiç çağrılmadıysa 0 döndürür.

Açıklamalar

çağırmadan önce FindNextFile'ı en az bir kez çağırmanız GetLastAccessTimegerekir.

Not

Bu işlev tarafından döndürülen zaman damgasını uygulamak için tüm dosya sistemleri aynı semantiği kullanmaz. Temel alınan dosya sistemi veya sunucu time özniteliğinin tutulmasını desteklemiyorsa, bu işlev diğer zaman damgası işlevleri tarafından döndürülen değeri döndürebilir. Zaman biçimleri hakkında bilgi için WIN32_FIND_DATA yapısına bakın. Bazı işletim sistemlerinde döndürülen saat, dosyanın bulunduğu makinenin yerel saat dilimindedir. Daha fazla bilgi için win32 FileTimeToLocalFileTime API'sine bakın.

CGopherFileFind::GetLastWriteTime

Dosyanın son değiştirildiği zamanı alır.

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

Parametreler

pTimeStamp
Dosyanın son yazıldığı saati içeren FILETIME yapısının işaretçisi.

refTime
CTime nesnesine başvuru.

Dönüş Değeri

Başarılı olursa sıfır olmayan; Başarısız olursa 0. GetLastWriteTimeyalnızca Bu CGopherFileFind nesnede FindNextFile hiç çağrılmadıysa 0 döndürür.

Açıklamalar

çağırmadan önce FindNextFile'ı en az bir kez çağırmanız GetLastWriteTimegerekir.

Not

Bu işlev tarafından döndürülen zaman damgasını uygulamak için tüm dosya sistemleri aynı semantiği kullanmaz. Temel alınan dosya sistemi veya sunucu time özniteliğinin tutulmasını desteklemiyorsa, bu işlev diğer zaman damgası işlevleri tarafından döndürülen değeri döndürebilir. Zaman biçimleri hakkında bilgi için WIN32_FIND_DATA yapısına bakın. Bazı işletim sistemlerinde döndürülen saat, dosyanın bulunduğu makinenin yerel saat dilimindedir. Daha fazla bilgi için win32 FileTimeToLocalFileTime API'sine bakın.

CGopherFileFind::GetLength

Bulunan dosyanın uzunluğunu bayt cinsinden almak için bu üye işlevini çağırın.

virtual ULONGLONG GetLength() const;

Dönüş Değeri

Bulunan dosyanın bayt cinsinden uzunluğu.

Açıklamalar

GetLength dosya boyutunun değerini bayt cinsinden almak için Win32 yapısı WIN32_FIND_DATA kullanır.

Not

MFC 7.0 itibarıyla GetLength 64 bit tamsayı türlerini destekler. Kitaplığın bu yeni sürümüyle oluşturulmuş daha önce var olan kod, kesme uyarılarına neden olabilir.

Örnek

CFile::GetLength (temel sınıf uygulaması) örneğine bakın.

CGopherFileFind::GetLocator

FindFile'ın gopher dosyasını bulmak için kullandığı CGopherLocator nesnesini almak için bu üye işlevini çağırın.

CGopherLocator GetLocator() const;

Dönüş Değeri

Bir CGopherLocator nesnesi.

CGopherFileFind::GetScreenName

Gopher ekranının adını almak için bu üye işlevini çağırın.

CString GetScreenName() const;

Dönüş Değeri

Şifre ekranının adı.

CGopherFileFind::IsDots

Dosyalar arasında yineleme yaparken geçerli dizin ve üst dizin işaretçilerini test eder.

virtual BOOL IsDots() const;

Dönüş Değeri

Bulunan dosyanın adı "." veya ".." ise, bulunan dosyanın aslında bir dizin olduğunu gösterir. Aksi takdirde 0.

Açıklamalar

çağırmadan önce FindNextFile'ı en az bir kez çağırmanız IsDotsgerekir.

Ayrıca bkz.

CFileFind Sınıfı
Hiyerarşi Grafiği
CFtpFileFind Sınıfı
CFileFind Sınıfı
CInternetFile Sınıfı
CGopherFile Sınıfı
CHttpFile Sınıfı