Funzione FtpSetCurrentDirectoryA (wininet.h)

Articolo
03/08/2023

Cambia in una directory di lavoro diversa nel server FTP.

Sintassi

BOOL FtpSetCurrentDirectoryA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszDirectory
);

Parametri

[in] hConnect

Gestire in una sessione FTP.

[in] lpszDirectory

Puntatore a una stringa con terminazione null contenente il nome della directory per diventare la directory di lavoro corrente. Può trattarsi di un percorso completo o di un nome relativo alla directory corrente.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per ottenere un messaggio di errore specifico, chiamare GetLastError. Se il messaggio di errore indica che il server FTP ha negato la richiesta di modificare una directory, usare InternetGetLastResponseInfo per determinare perché.

Commenti

Un'applicazione deve usare FtpGetCurrentDirectory per determinare la directory di lavoro corrente del sito remoto, anziché presupponere che il sistema remoto usi uno schema di denominazione gerarchico per le directory.

Il parametro lpszDirectory può essere parzialmente o completo dei nomi di file relativi 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 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 FtpSetCurrentDirectory 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


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