Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function changes to a different working directory on the FTP server.

Syntax 

BOOL WINAPI FtpSetCurrentDirectory(
  HINTERNET 
hConnect, 
  LPCTSTR 
lpszDirectory
);

Parameters

hConnect

[in] Valid handle to an FTP session.

lpszDirectory

[in] Long pointer to a null-terminated string that contains the name of the directory to change to 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 change a directory, use InternetGetLastResponseInfoto determine the cause.

Remarks

An application should use the FtpGetCurrentDirectoryfunction to determine the remote site's current working directory, instead of assuming that the remote system uses a hierarchical naming scheme for directories.

The lpszDirectoryparameter 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. FtpSetCurrentDirectorytranslates 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