Condividi tramite

Classe CGopherFileFind

  • Articolo

Facilita le ricerche di file su Internet dei server gopher.

Nota

Le classi CGopherConnection, CGopherFile, CGopherFileFinde CGopherLocator i relativi membri sono stati deprecati perché non funzionano sulla piattaforma Windows XP, ma continueranno a funzionare su piattaforme precedenti.

Sintassi

class CGopherFileFind : public CFileFind

Membri

Costruttori pubblici

Nome Descrizione
CGopherFileFind::CGopherFileFind Costruisce un oggetto CGopherFileFind.

Metodi pubblici

Nome Descrizione
CGopherFileFind::FindFile Trova un file in un server gopher.
CGopherFileFind::FindNextFile Continua una ricerca di file da una chiamata precedente a FindFile.
CGopherFileFind::GetCreationTime Ottiene l'ora di creazione del file specificato.
CGopherFileFind::GetLastAccessTime Ottiene l'ora dell'ultimo accesso al file specificato.
CGopherFileFind::GetLastWriteTime Ottiene l'ora dell'ultima scrittura del file specificato.
CGopherFileFind::GetLength Ottiene la lunghezza del file trovato, in byte.
CGopherFileFind::GetLocator Ottenere un CGopherLocator oggetto .
CGopherFileFind::GetScreenName Ottiene il nome di una schermata gopher.
CGopherFileFind::IsDots Verifica la directory corrente e i marcatori di directory padre durante l'iterazione dei file.

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.

Nota

CGopherFileFind non supporta le funzioni membro seguenti della relativa classe base CFileFind:

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.

Nota

Non tutti i file system usano la stessa semantica per implementare il timestamp restituito da questa funzione. Questa funzione può restituire lo stesso valore restituito da altre funzioni timestamp se il file system o il server sottostante non supporta la conservazione dell'attributo time. Per informazioni sui formati temporali, vedere la struttura WIN32_FIND_DATA . In alcuni sistemi operativi, l'ora restituita si trova nel fuso orario locale del computer in cui si trova il file. Per altre informazioni, vedere l'API Win32 FileTimeToLocalFileTime .

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.

Nota

Non tutti i file system usano la stessa semantica per implementare il timestamp restituito da questa funzione. Questa funzione può restituire lo stesso valore restituito da altre funzioni timestamp se il file system o il server sottostante non supporta la conservazione dell'attributo time. Per informazioni sui formati temporali, vedere la struttura WIN32_FIND_DATA . In alcuni sistemi operativi, l'ora restituita si trova nel fuso orario locale del computer in cui si trova il file. Per altre informazioni, vedere l'API Win32 FileTimeToLocalFileTime .

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.

Nota

Non tutti i file system usano la stessa semantica per implementare il timestamp restituito da questa funzione. Questa funzione può restituire lo stesso valore restituito da altre funzioni timestamp se il file system o il server sottostante non supporta la conservazione dell'attributo time. Per informazioni sui formati temporali, vedere la struttura WIN32_FIND_DATA . In alcuni sistemi operativi, l'ora restituita si trova nel fuso orario locale del computer in cui si trova il file. Per altre informazioni, vedere l'API Win32 FileTimeToLocalFileTime .

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.

Nota

A partire da MFC 7.0, GetLength supporta tipi integer a 64 bit. Il codice esistente creato in precedenza con questa versione più recente della libreria può generare avvisi di troncamento.

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