Funzione FtpPutFileA (wininet.h)

Articolo
03/09/2024

Archivia un file nel server FTP.

Sintassi

BOOL FtpPutFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocalFile,
  [in] LPCSTR    lpszNewRemoteFile,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parametri

[in] hConnect

Handle in una sessione FTP.

[in] lpszLocalFile

Puntatore a una stringa con terminazione Null contenente il nome del file da inviare dal sistema locale.

[in] lpszNewRemoteFile

Puntatore a una stringa con terminazione Null contenente il nome del file da creare nel sistema remoto.

[in] dwFlags

Condizioni in base alle quali si verificano i trasferimenti. L'applicazione deve selezionare un tipo di trasferimento e uno qualsiasi dei flag che controllano la modalità di controllo della memorizzazione nella cache del file.

Il tipo di trasferimento può essere uno dei valori seguenti.

Valore	Significato
FTP_TRANSFER_TYPE_ASCII	Trasferisce il file usando il metodo di trasferimento ASCII (Tipo A) ftp. Le informazioni di controllo e formattazione vengono convertite in equivalenti locali.
FTP_TRANSFER_TYPE_BINARY	Trasferisce il file usando il metodo di trasferimento Image (Type I) ftp. Il file viene trasferito esattamente come esiste senza modifiche. Si tratta del metodo di trasferimento predefinito.
FTP_TRANSFER_TYPE_UNKNOWN	Il valore predefinito è FTP_TRANSFER_TYPE_BINARY.
INTERNET_FLAG_TRANSFER_ASCII	Trasferisce il file come ASCII.
INTERNET_FLAG_TRANSFER_BINARY	Trasferisce il file come binario.

I valori seguenti vengono usati per controllare la memorizzazione nella cache del file. L'applicazione può usare uno o più dei valori seguenti.

Valore	Significato
INTERNET_FLAG_HYPERLINK	Forza un ricaricamento se non è presente un'ora di scadenza e non viene restituito alcun tempo LastModified dal server quando si determina se ricaricare l'elemento dalla rete.
INTERNET_FLAG_NEED_FILE	Determina la creazione di un file temporaneo se il file non può essere memorizzato nella cache.
INTERNET_FLAG_RELOAD	Impone un download del file, dell'oggetto o dell'elenco di directory richiesto dal server di origine e non dalla cache.
INTERNET_FLAG_RESYNCHRONIZE	Ricarica le risorse HTTP se la risorsa è stata modificata dall'ultima volta che è stata scaricata. Tutte le risorse FTP vengono ricaricate. Windows XP e Windows Server 2003 R2 e versioni precedenti: Vengono ricaricate anche le risorse gopher.

[in] dwContext

Puntatore a una variabile che contiene il valore definito dall'applicazione che associa questa ricerca a tutti i dati dell'applicazione. Questo parametro viene usato solo se l'applicazione ha già chiamato InternetSetStatusCallback per configurare un callback di stato.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario. Per ottenere un messaggio di errore specifico, chiamare GetLastError.

Commenti

FtpPutFile è una routine di alto livello che gestisce tutta la contabilità e l'overhead associati alla lettura di un file in locale e all'archiviazione in un server FTP. Un'applicazione che deve inviare solo i dati dei file o che richiede un controllo ravvicinato sul trasferimento di file deve usare le funzioni FtpOpenFile e InternetWriteFile .

Se il parametro dwFlags specifica FILE_TRANSFER_TYPE_ASCII, la conversione dei dati dei file converte i caratteri di controllo e formattazione in equivalenti locali.

Sia lpszNewRemoteFile che lpszLocalFile possono essere nomi di file parzialmente o completi rispetto alla directory corrente.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).

Nota

L'intestazione wininet.h definisce FtpPutFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

Sessioni FTP

Funzioni WinINet

Share via