Removes the specified directory on the FTP server.
Syntax
BOOL FtpRemoveDirectory(
__in HINTERNET hConnect,
__in LPCTSTR lpszDirectory
);
Parameters
- hConnect [in]
-
Handle to an FTP session.
- lpszDirectory [in]
-
Pointer to a null-terminated string that contains the name of the directory to be removed. This can be either a fully qualified path or a name relative to the current directory.
Return Value
Returns TRUE if successful, or FALSE otherwise. To get a specific error message, call
GetLastError. If the error message indicates that the FTP server denied the request to remove a directory, use
InternetGetLastResponseInfo to determine why.
Remarks
An application should use
FtpGetCurrentDirectory to determine the remote site's current working directory, instead of assuming that the remote system uses a hierarchical naming scheme for directories.
The
lpszDirectory parameter can be either partially or fully qualified file names relative to the current directory.
Requirements
| Client | Requires Windows Vista, Windows XP, Windows 2000 Professional, Windows NT Workstation 4.0, Windows Me, Windows 98, or Windows 95. |
|---|
| Server | Requires Windows Server 2008, Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0. |
|---|
| Version | Requires Internet Explorer 3.0 or later. |
|---|
| Header | Declared in Wininet.h. |
|---|
| Library | Use Wininet.lib. |
|---|
| DLL | Requires Wininet.dll. |
|---|
| Unicode/ANSI | Implemented as FtpRemoveDirectoryW (Unicode) and FtpRemoveDirectoryA (ANSI). |
|---|
See Also
FTP Sessions
WinINet Functions
Send comments about this topic to Microsoft
Build date: 10/2/2008