Funzione FtpGetCurrentDirectoryA (wininet.h)

Articolo
03/13/2024

Recupera la directory corrente per la sessione FTP specificata.

Sintassi

BOOL FtpGetCurrentDirectoryA(
  [in]      HINTERNET hConnect,
  [out]     LPSTR     lpszCurrentDirectory,
  [in, out] LPDWORD   lpdwCurrentDirectory
);

Parametri

[in] hConnect

Handle in una sessione FTP.

[out] lpszCurrentDirectory

Puntatore a una stringa con terminazione Null che riceve il percorso assoluto della directory corrente.

[in, out] lpdwCurrentDirectory

Puntatore a una variabile che specifica la lunghezza del buffer, in TCHAR. La lunghezza del buffer deve includere spazio per un carattere null di terminazione. L'uso di una lunghezza di MAX_PATH è sufficiente per tutti i percorsi. Al termine della funzione, la variabile riceve il numero di caratteri copiati nel buffer.

Valore restituito

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

Commenti

Se il buffer lpszCurrentDirectory non è sufficientemente grande, lpdwCurrentDirectory riceve il numero di byte necessari per recuperare il nome completo della directory corrente.

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

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

FtpSetCurrentDirectory

Funzioni WinINet

Condividi tramite