Classe CGopherFileFind

Facilita le ricerche di file su Internet dei server gopher.

Sintassi

class CGopherFileFind : public CFileFind

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

CGopherFileFind include funzioni membro che iniziano una ricerca, individuano un file e restituiscono l'URL di un file.

Altre classi MFC progettate per La ricerca di file locali e Internet includono CFtpFileFind e CFileFind. CGopherFileFindInsieme a , queste classi forniscono un meccanismo semplice per consentire all'utente di trovare file specifici, indipendentemente dal protocollo del server, dal tipo di file o dal percorso (un computer locale o un server remoto). Si noti che non esiste alcuna classe MFC per la ricerca nei server HTTP perché HTTP non supporta la manipolazione diretta dei file richiesta dalle ricerche.

• GetRoot

• GetFileName

• GetFilePath

• GetFileTitle

• GetFileURL

Inoltre, se usato con CGopherFileFind, la CFileFind funzione membro IsDots è sempre FALSE.

Per altre informazioni su come usare CGopherFileFind e le altre classi WinInet, vedere l'articolo Programmazione Internet con WinInet.

Gerarchia di ereditarietà

CObject

CFileFind

CGopherFileFind

Requisiti

Intestazione: afxinet.h

CGopherFileFind::CGopherFileFind

Questa funzione membro viene chiamata per costruire un CGopherFileFind oggetto .

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

Parametri

pConnection
Puntatore a un oggetto CGopherConnection .

dwContext
Identificatore di contesto per l'operazione . Per altre informazioni su dwContext, vedere Osservazioni.

Osservazioni:

Il valore predefinito per dwContext viene inviato da MFC all'oggetto dall'oggetto CGopherFileFind CInternetSession che ha creato l'oggetto CGopherFileFind . Quando si costruisce un CGopherFileFind oggetto, è possibile eseguire l'override dell'impostazione predefinita per impostare l'identificatore di contesto su un valore scelto. L'identificatore di contesto viene restituito a CInternetSession::OnStatusCallback per fornire lo stato sull'oggetto con cui viene identificato. Per altre informazioni sull'identificatore di contesto, vedere l'articolo Passaggi preliminari su Internet: WinInet .

CGopherFileFind::FindFile

Chiamare questa funzione membro per trovare un file gopher.

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

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

Parametri

refLocator
Riferimento a un oggetto CGopherLocator .

pstrString
Puntatore a una stringa contenente il nome del file.

dwFlags
Flag che descrivono come gestire questa sessione. I flag validi sono:

• INTERNET_FLAG_RELOAD Recuperare i dati dal server remoto anche se sono memorizzati nella cache locale.

• INTERNET_FLAG_DONT_CACHE Non memorizzare nella cache i dati, in locale o in qualsiasi gateway.

• INTERNET_FLAG_SECURE Richiedere transazioni sicure in transito con Secure Sockets Layer o PCT. Questo flag è applicabile solo alle richieste HTTP.

• INTERNET_FLAG_USE_EXISTING Se possibile, riutilizzare le connessioni esistenti al server per le nuove FindFile richieste anziché creare una nuova sessione per ogni richiesta.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0. Per ottenere informazioni estese sull'errore, chiamare la funzione Win32 GetLastError.

Osservazioni:

Dopo aver chiamato FindFile per recuperare il primo oggetto gopher, è possibile chiamare FindNextFile per recuperare i file gopher successivi.

CGopherFileFind::FindNextFile

Chiamare questa funzione membro per continuare una ricerca di file iniziata con una chiamata a CGopherFileFind::FindFile.

virtual BOOL FindNextFile();

Valore restituito

Diverso da zero se sono presenti più file; zero se il file trovato è l'ultimo nella directory o se si è verificato un errore. Per ottenere informazioni estese sull'errore, chiamare la funzione Win32 GetLastError. Se il file trovato è l'ultimo file nella directory o se non è possibile trovare file corrispondenti, la GetLastError funzione restituisce ERROR_NO_MORE_FILES.

CGopherFileFind::GetCreationTime

Ottiene l'ora di creazione per il file corrente.

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

Parametri

pTimeStamp
Puntatore a una struttura FILETIME contenente l'ora di creazione del file.

refTime
Riferimento a un oggetto CTime .

Valore restituito

Diverso da zero se ha esito positivo; 0 in caso di esito negativo. GetCreationTime restituisce 0 solo se FindNextFile non è mai stato chiamato su questo CGopherFileFind oggetto.

Osservazioni:

È necessario chiamare FindNextFile almeno una volta prima di chiamare GetCreationTime.

CGopherFileFind::GetLastAccessTime

Ottiene l'ora dell'ultimo accesso al file specificato.

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

Parametri

refTime
Riferimento a un oggetto CTime .

pTimeStamp
Puntatore a una struttura FILETIME contenente l'ora dell'ultimo accesso al file.

Valore restituito

Diverso da zero se ha esito positivo; 0 in caso di esito negativo. GetLastAccessTime restituisce 0 solo se FindNextFile non è mai stato chiamato su questo CGopherFileFind oggetto.

Osservazioni:

È necessario chiamare FindNextFile almeno una volta prima di chiamare GetLastAccessTime.

CGopherFileFind::GetLastWriteTime

Ottiene l'ultima volta che il file è stato modificato.

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

Parametri

pTimeStamp
Puntatore a una struttura FILETIME contenente l'ora dell'ultima scrittura del file.

refTime
Riferimento a un oggetto CTime .

Valore restituito

Diverso da zero se ha esito positivo; 0 in caso di esito negativo. GetLastWriteTime restituisce 0 solo se FindNextFile non è mai stato chiamato su questo CGopherFileFind oggetto.

Osservazioni:

È necessario chiamare FindNextFile almeno una volta prima di chiamare GetLastWriteTime.

CGopherFileFind::GetLength

Chiamare questa funzione membro per ottenere la lunghezza, in byte, del file trovato.

virtual ULONGLONG GetLength() const;

Valore restituito

Lunghezza, in byte, del file trovato.

Osservazioni:

GetLength usa la struttura Win32 WIN32_FIND_DATA per ottenere il valore delle dimensioni del file in byte.

Esempio

Vedere l'esempio per CFile::GetLength (implementazione della classe di base).

CGopherFileFind::GetLocator

Chiamare questa funzione membro per ottenere l'oggetto CGopherLocator usato da FindFile per trovare il file gopher.

CGopherLocator GetLocator() const;

Valore restituito

Oggetto CGopherLocator.

CGopherFileFind::GetScreenName

Chiamare questa funzione membro per ottenere il nome della schermata gopher.

CString GetScreenName() const;

Valore restituito

Nome della schermata gopher.

CGopherFileFind::IsDots

Verifica la directory corrente e i marcatori di directory padre durante l'iterazione dei file.

virtual BOOL IsDots() const;

Valore restituito

Diverso da zero se il file trovato ha il nome "." o ".".", che indica che il file trovato è effettivamente una directory. In caso contrario, 0

Osservazioni:

È necessario chiamare FindNextFile almeno una volta prima di chiamare IsDots.

Vedi anche

Classe CFileFind
Grafico della gerarchia
Classe CFtpFileFind
Classe CFileFind
Classe CInternetFile
Classe CGopherFile
Classe CHttpFile