Funzione FtpRenameFileA (wininet.h)

Articolo
08/27/2023

Rinomina un file archiviato nel server FTP.

Sintassi

BOOL FtpRenameFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszExisting,
  [in] LPCSTR    lpszNew
);

Parametri

[in] hConnect

Gestire in una sessione FTP.

[in] lpszExisting

Puntatore a una stringa con terminazione null contenente il nome del file da rinominare.

[in] lpszNew

Puntatore a una stringa con terminazione null contenente il nuovo nome per il file remoto.

Valore restituito

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

Commenti

I parametri lpszExisting e lpszNew possono essere nomi di file parzialmente o completi 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 FtpRenameFile 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

Condividi tramite