FtpCreateDirectory
A version of this page is also available for
4/8/2010
This function creates a new directory on the FTP server.
Syntax
BOOL WINAPI FtpCreateDirectory(
HINTERNET hConnect,
LPCTSTR lpszDirectory
);
Parameters
- hConnect
[in] Valid handle to an FTP session. This handle must have been returned by a previous call to the InternetConnect function.
- lpszDirectory
[in] Long pointer to a null-terminated string that contains the name of the directory to create on the remote system. This can be either a fully qualified path or a name relative to the current directory.
Return Value
TRUE indicates success. FALSE indicates failure. To get extended error data, call GetLastError. If the error message indicates that the FTP server denied the request to create a directory, use the InternetGetLastResponseInfo function to determine the cause.
Remarks
An application should use the FtpGetCurrentDirectory function 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. A backward slash (\) or forward slash (/) can be used as the directory separator for either name. FtpCreateDirectory translates the directory name separators to the appropriate character before they are used.
Requirements
| Header | wininet.h |
| Library | wininet.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
FtpGetCurrentDirectory
InternetConnect
InternetGetLastResponseInfo
WinInet Functions