Funzione FtpCommandW (wininet.h)

Articolo
03/04/2024

La funzione FtpCommand invia comandi direttamente a un server FTP.

Sintassi

BOOL FtpCommandW(
  [in]  HINTERNET hConnect,
  [in]  BOOL      fExpectResponse,
  [in]  DWORD     dwFlags,
  [in]  LPCWSTR   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 opzione 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 (Type 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 contenente 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 phFtpCommand da compilare.

Valore restituito

Restituisce TRUE se ha esito positivo 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 dall'interno di DllMain o dai costruttori e distruttori degli oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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

Condividi tramite