Funzione FtpPutFileA (wininet.h)

Articolo
11/20/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 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 (Type 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 per determinare 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	Forza un download del file, dell'oggetto o dell'elenco di directory richiesto dal server di origine, 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. anche le risorse di Windows XP e Windows Server 2003 R2 e versioni precedenti: vengono ricaricate anche le risorse di Gopher .

[in] dwContext

Puntatore a una variabile che contiene il valore definito dall'applicazione che associa la 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 in caso di esito positivo oppure FALSE in caso contrario. Per ottenere un messaggio di errore specifico, chiamare GetLastError.

Osservazioni

FtpPutFile è una routine di alto livello che gestisce tutte le operazioni di contabilità e sovraccarico associate alla lettura di un file localmente e all'archiviazione in un server FTP. Un'applicazione che deve inviare solo dati di file o che richiede un controllo di chiusura 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 dall'interno di 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 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wininet.h
libreria	Wininet.lib
dll	Wininet.dll

Vedere anche

sessioni FTP

funzioni WinINet

Condividi tramite