Funzione FtpGetCurrentDirectoryA (wininet.h)

Articolo
11/20/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. Quando la funzione termina, la variabile riceve il numero di caratteri copiati nel buffer.

Valore restituito

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

Osservazioni

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

FtpSetCurrentDirectory

funzioni WinINet

Condividi tramite