Classe CGopherFileFind
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 FAL edizione Standard.
Per altre informazioni su come usare CGopherFileFind e le altre classi WinInet, vedere l'articolo Programmazione Internet con WinInet.
Gerarchia di ereditarietà
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 CGopher Connessione ion.
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 CGopherFileFindCInternetSession 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_edizione Standard CURE Richiedere transazioni sicure in transito con Secure Sockets Layer o PCT. Questo flag è applicabile solo alle richieste HTTP.
INTERNET_FLAG_Uedizione Standard_EXISTING Se possibile, riutilizzare le connessioni esistenti al server per le nuove
FindFilerichieste 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per