Funzione FtpCommandW (wininet.h)

Articolo
11/20/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 venga stabilita una connessione dati dal server FTP. Deve essere impostato 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 phFtpCommand da riempire.

Valore restituito

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario. Per ottenere un messaggio di errore specifico, chiamare GetLastError.

Osservazioni

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