Funzione FtpCommandA (wininet.h)

  • Articolo

La funzione FtpCommand invia comandi direttamente a un server FTP.

Sintassi

BOOL FtpCommandA(
  [in]  HINTERNET hConnect,
  [in]  BOOL      fExpectResponse,
  [in]  DWORD     dwFlags,
  [in]  LPCSTR    lpszCommand,
  [in]  DWORD_PTR dwContext,
  [out] HINTERNET *phFtpCommand
);

Parametri

[in] hConnect

Handle restituito da una chiamata a InternetConnect.

[in] fExpectResponse

Valore booleano che indica se l'applicazione prevede che una connessione dati venga stabilita dal server FTP. Questa impostazione deve essere impostata su TRUE se è prevista una connessione dati o FALSE in caso contrario.

[in] dwFlags

Parametro che può essere impostato su uno dei valori seguenti.

Valore Significato
FTP_TRANSFER_TYPE_ASCII
 Trasferisce il file usando il metodo di trasferimento FTP ASCII (tipo A). I dati di controllo e formattazione vengono convertiti in equivalenti locali.
FTP_TRANSFER_TYPE_BINARY
 Trasferisce il file usando il metodo di trasferimento FTP Image (Type I). Il file viene trasferito esattamente senza modifiche. Si tratta del metodo di trasferimento predefinito.

[in] lpszCommand

Puntatore a una stringa contenente il comando da inviare al server FTP.

[in] dwContext

Puntatore a una variabile che contiene un valore definito dall'applicazione usato per identificare il contesto dell'applicazione nelle operazioni di callback.

[out] phFtpCommand

Puntatore a un handle creato se viene aperto un socket di dati valido. Il parametro fExpectResponse deve essere impostato su TRUE per il riempimento di phFtpCommand .

Valore restituito

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

Commenti

GetLastError può restituire ERROR_INTERNET_NO_DIRECT_ACCESS se l'applicazione client è offline. Se uno o più parametri non sono validi, GetLastError restituirà ERROR_INVALID_PARAMETER.

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 FtpCommand 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

   
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