CFtpConnection 클래스
인터넷 서버에 대한 FTP 연결을 관리하고 해당 서버의 디렉터리 및 파일을 직접 조작할 수 있습니다.
구문
class CFtpConnection : public CInternetConnection
멤버
공용 생성자
속성 | 설명 |
---|---|
CFtpConnection::CFtpConnection | CFtpConnection 개체를 생성합니다. |
공용 메서드
이름 | 설명 |
---|---|
CFtpConnection::Command | FTP 서버에 직접 명령을 보냅니다. |
CFtpConnection::CreateDirectory | 서버에 디렉터리를 만듭니다. |
CFtpConnection::GetCurrentDirectory | 이 연결의 현재 디렉터리를 가져옵니다. |
CFtpConnection::GetCurrentDirectoryAsURL | 이 연결의 현재 디렉터리를 URL로 가져옵니다. |
CFtpConnection::GetFile | 연결된 서버에서 파일을 가져옵니다. |
CFtpConnection::OpenFile | 연결된 서버에서 파일을 엽니다. |
CFtpConnection::PutFile | 서버에 파일을 배치합니다. |
CFtpConnection::Remove | 서버에서 파일을 제거합니다. |
CFtpConnection::RemoveDirectory | 서버에서 지정된 디렉터리를 제거합니다. |
CFtpConnection::Rename | 서버의 파일 이름을 바꿉니다. |
CFtpConnection::SetCurrentDirectory | 현재 FTP 디렉터리를 설정합니다. |
설명
FTP는 MFC WinInet 클래스에서 인식하는 세 가지 인터넷 서비스 중 하나입니다.
FTP 인터넷 서버와 통신하려면 먼저 CInternetSession 인스턴스를 만든 다음 개체를 CFtpConnection
만들어야 합니다. 개체를 직접 만들지 않고, 개체를 CFtpConnection
만들고 CFtpConnection
포인터를 반환하는 CInternetSession::GetFtpConnection을 호출합니다.
다른 MFC 인터넷 클래스의 작동 방식에 CFtpConnection
대한 자세한 내용은 WinInet을 사용한 인터넷 프로그래밍 문서를 참조하세요. 지원되는 다른 두 서비스인 HTTP 및 gopher와 통신하는 방법에 대한 자세한 내용은 CHttpConnection 및 CGopherConnection 클래스를 참조하세요.
예시
CFtpFileFind 클래스 개요의 예제를 참조하세요.
상속 계층 구조
CFtpConnection
요구 사항
헤더: afxinet.h
CFtpConnection::CFtpConnection
이 멤버 함수는 개체를 생성하기 위해 호출됩니다 CFtpConnection
.
CFtpConnection(
CInternetSession* pSession,
HINTERNET hConnected,
LPCTSTR pstrServer,
DWORD_PTR dwContext);
CFtpConnection(
CInternetSession* pSession,
LPCTSTR pstrServer,
LPCTSTR pstrUserName = NULL,
LPCTSTR pstrPassword = NULL,
DWORD_PTR dwContext = 0,
INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
BOOL bPassive = FALSE);
매개 변수
pSession
관련 CInternetSession 개체에 대한 포인터입니다.
hConnected
현재 인터넷 세션의 Windows 핸들입니다.
pstrServer
FTP 서버 이름을 포함하는 문자열에 대한 포인터입니다.
dwContext
작업에 대한 컨텍스트 식별자입니다. dwContext는 CInternetSession::OnStatusCallback에서 반환된 작업의 상태 정보를 식별합니다. 기본값은 1로 설정되지만, 작업에 대한 특정 컨텍스트 ID를 명시적으로 할당할 수도 있습니다. 개체와 개체가 수행하는 모든 작업은 해당 컨텍스트 ID와 연결됩니다.
pstrUserName
로그인할 사용자의 이름을 지정하는, null로 끝나는 문자열에 대한 포인터입니다. NULL인 경우 기본값은 익명입니다.
pstrPassword
로그인하는 데 사용할 암호를 지정하는, null로 끝나는 문자열에 대한 포인터입니다. pstrPassword와 pstrUserName이 모두 NULL인 경우 기본 익명 암호는 사용자의 전자 메일 이름입니다. pstrPassword가 NULL(또는 빈 문자열)이지만 pstrUserName이 NULL이 아닌 경우 빈 암호가 사용됩니다. 다음 표에서는 pstrUserName 및 pstrPassword의 네 가지 가능한 설정에 대한 동작을 설명합니다.
pstrUserName | pstrPassword | 사용자 이름을 FTP 서버로 전송 | 암호를 FTP 서버로 전송 |
---|---|---|---|
NULL 또는 " | NULL 또는 " | "anonymous" | 사용자의 이메일 이름 |
NULL이 아닌 문자열 | NULL 또는 " | pstrUserName | " " |
NULL 비 NULL 문자열 | 오류 | 오류 | |
NULL이 아닌 문자열 | NULL이 아닌 문자열 | pstrUserName | pstrPassword |
nPort
서버에서 사용할 TCP/IP 포트를 식별하는 숫자입니다.
bPassive
이 FTP 세션에 대한 수동 또는 활성 모드를 지정합니다. TRUE로 설정하면 Win32 API dwFlag 를 INTERNET_FLAG_PASSIVE 설정합니다.
설명
개체를 CFtpConnection
직접 만들지 않습니다. 대신 개체를 만드는 CInternetSession::GetFtpConnection을 호출합니다CFptConnection
.
CFtpConnection::Command
FTP 서버에 직접 명령을 보냅니다.
CInternetFile* Command(
LPCTSTR pszCommand,
CmdResponseType eResponse = CmdRespNone,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1);
매개 변수
pszCommand
보낼 명령을 포함하는 문자열에 대한 포인터입니다.
eResponse
FTP 서버에서 응답이 필요한지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.
CmdRespNone
응답이 필요하지 않습니다.CmdRespRead
응답이 필요합니다.CmdRespWrite
사용되지 않습니다.
CmdResponseType은 afxinet.h에 정의된 CFtpConnection의 멤버입니다.
dwFlags
이 함수를 제어하는 플래그를 포함하는 값입니다. 전체 목록은 FTPCommand를 참조하세요.
dwContext
콜백에서 애플리케이션 컨텍스트를 식별하는 데 사용되는 애플리케이션 정의 값을 포함하는 값에 대한 포인터입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
설명
이 멤버 함수는 Windows SDK에 설명된 대로 FTPCommand 함수의 기능을 에뮬레이트합니다.
오류가 발생하면 MFC는 CInternetException 형식의 예외를 throw합니다.
CFtpConnection::CreateDirectory
이 멤버 함수를 호출하여 연결된 서버에 디렉터리를 만듭니다.
BOOL CreateDirectory(LPCTSTR pstrDirName);
매개 변수
pstrDirName
만들 디렉터리의 이름을 포함하는 문자열에 대한 포인터입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Windows 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
서버에 대한 이 연결의 현재 작업 디렉터리를 확인하는 데 사용합니다 GetCurrentDirectory
. 원격 시스템이 사용자를 루트 디렉터리에 연결한 것으로 가정하지 마세요.
매개 변수는 pstrDirName
현재 디렉터리를 기준으로 부분적으로 또는 정규화된 파일 이름일 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. CreateDirectory
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
CFtpConnection::GetCurrentDirectory
이 멤버 함수를 호출하여 현재 디렉터리의 이름을 가져옵니다.
BOOL GetCurrentDirectory(CString& strDirName) const;
BOOL GetCurrentDirectory(
LPTSTR pstrDirName,
LPDWORD lpdwLen) const;
매개 변수
strDirName
디렉터리의 이름을 받을 문자열에 대한 참조입니다.
pstrDirName
디렉터리의 이름을 받을 문자열에 대한 포인터입니다.
lpdwLen
다음 정보를 포함하는 DWORD에 대한 포인터입니다.
항목: pstrDirName에서 참조하는 버퍼의 크기입니다.
반환: pstrDirName에 저장된 문자 수입니다. 멤버 함수가 실패하고 ERROR_INSUFFICIENT_BUFFER 반환 되는 경우 lpdwLen 에는 문자열을 받기 위해 애플리케이션이 할당해야 하는 바이트 수가 포함됩니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
대신 디렉터리 이름을 URL로 얻으려면 GetCurrentDirectoryAsURL을 호출합니다.
매개 변수 pstrDirName 또는 strDirName 은 현재 디렉터리를 기준으로 부분적으로 정규화된 파일 이름이거나 정규화될 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. GetCurrentDirectory
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
CFtpConnection::GetCurrentDirectoryAsURL
이 멤버 함수를 호출하여 현재 디렉터리의 이름을 URL로 가져옵니다.
BOOL GetCurrentDirectoryAsURL(CString& strDirName) const;
BOOL GetCurrentDirectoryAsURL(
LPTSTR pstrName,
LPDWORD lpdwLen) const;
매개 변수
strDirName
디렉터리의 이름을 받을 문자열에 대한 참조입니다.
pstrDirName
디렉터리의 이름을 받을 문자열에 대한 포인터입니다.
lpdwLen
다음 정보를 포함하는 DWORD에 대한 포인터입니다.
항목: pstrDirName에서 참조하는 버퍼의 크기입니다.
반환: pstrDirName에 저장된 문자 수입니다. 멤버 함수가 실패하고 ERROR_INSUFFICIENT_BUFFER 반환 되는 경우 lpdwLen 에는 문자열을 받기 위해 애플리케이션이 할당해야 하는 바이트 수가 포함됩니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
GetCurrentDirectoryAsURL
는 GetCurrentDirectory와 동일하게 동작합니다.
매개 변수 strDirName 은 현재 디렉터리를 기준으로 부분적으로 정규화된 파일 이름이거나 정규화될 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. GetCurrentDirectoryAsURL
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
CFtpConnection::GetFile
이 멤버 함수를 호출하여 FTP 서버에서 파일을 가져와서 로컬 컴퓨터에 저장합니다.
BOOL GetFile(
LPCTSTR pstrRemoteFile,
LPCTSTR pstrLocalFile,
BOOL bFailIfExists = TRUE,
DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1);
매개 변수
pstrRemoteFile
FTP 서버에서 검색할 파일의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
pstrLocalFile
로컬 시스템에서 만들 파일의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
bFailIfExists
기존 파일에서 파일 이름을 이미 사용할 수 있는지 여부를 나타냅니다. 로컬 파일 이름이 이미 있고 이 매개 변수가 TRUE GetFile
이면 실패합니다. 그렇지 않으면 GetFile
파일의 기존 복사본이 지워집니다.
dwAttributes
파일의 특성을 나타냅니다. 다음 FILE_ATTRIBUTE_* 플래그의 조합일 수 있습니다.
FILE_ATTRIBUTE_ARCHIVE 파일이 보관 파일입니다. 애플리케이션은 이 특성을 사용하여 백업 또는 제거를 위해 파일을 표시합니다.
FILE_ATTRIBUTE_COMPRESSED 파일 또는 디렉터리가 압축됩니다. 파일의 경우 압축은 파일의 모든 데이터가 압축됨을 의미합니다. 디렉터리의 경우 새로 만들어진 파일과 하위 디렉터리가 기본적으로 압축됩니다.
FILE_ATTRIBUTE_DIRECTORY 파일이 디렉터리입니다.
FILE_ATTRIBUTE_NORMAL 파일에 다른 특성 집합이 없습니다. 이 특성은 단독으로 사용하는 경우에만 유효합니다. 다른 모든 파일 특성은 FILE_ATTRIBUTE_NORMAL 재정의합니다.
FILE_ATTRIBUTE_HIDDEN 파일이 숨겨집니다. 일반 디렉터리 목록에는 포함되지 않습니다.
FILE_ATTRIBUTE_READONLY 파일이 읽기 전용입니다. 애플리케이션은 파일을 읽을 수 있지만 파일을 쓰거나 삭제할 수는 없습니다.
FILE_ATTRIBUTE_SYSTEM 파일이 운영 체제의 일부이거나 운영 체제에서만 사용됩니다.
FILE_ATTRIBUTE_TEMPORARY 파일이 임시 스토리지에 사용되고 있습니다. 애플리케이션은 반드시 필요한 경우에만 파일에 씁니다. 파일이 곧 삭제되므로 대부분의 파일 데이터는 미디어에 플러시되지 않고 메모리에 남아 있습니다.
dwFlags
전송이 발생하는 조건을 지정합니다. 이 매개 변수는 Windows SDK의 FtpGetFile에 설명된 모든 dwFlags 값일 수 있습니다.
dwContext
파일 검색에 대한 컨텍스트 식별자입니다. dwContext에 대한 자세한 내용은 비고를 참조하세요.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
GetFile
는 FTP 서버에서 파일을 읽고 로컬로 저장하는 것과 관련된 모든 오버헤드를 처리하는 고급 루틴입니다. 파일 데이터만 검색하거나 파일 전송을 면밀히 제어해야 하는 애플리케이션은 대신 CInternetFile::Read를 사용해야 OpenFile
합니다.
dwFlags가 FILE_TRANSFER_TYPE_ASCII 경우 파일 데이터를 변환하면 컨트롤 및 서식 문자도 Windows에 해당하는 문자로 변환됩니다. 기본 전송은 파일이 서버에 저장된 것과 동일한 형식으로 다운로드되는 이진 모드입니다.
pstrRemoteFile과 pstrLocalFile은 모두 현재 디렉터리를 기준으로 부분적으로 정규화된 파일 이름이거나 정규화될 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. GetFile
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
dwContext 기본값을 재정의하여 컨텍스트 식별자를 선택한 값으로 설정합니다. 컨텍스트 식별자는 CInternetSession 개체에서 만든 개체의 CFtpConnection
이 특정 작업과 연결됩니다. 이 값은 CInternetSession::OnStatusCallback에 반환되어 식별된 작업에 대한 상태를 제공합니다. 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.
CFtpConnection::OpenFile
이 멤버 함수를 호출하여 읽기 또는 쓰기를 위해 FTP 서버에 있는 파일을 엽니다.
CInternetFile* OpenFile(
LPCTSTR pstrFileName,
DWORD dwAccess = GENERIC_READ,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1);
매개 변수
pstrFileName
열 파일의 이름을 포함하는 문자열에 대한 포인터입니다.
dwAccess
파일에 액세스하는 방법을 결정합니다. GENERIC_READ 또는 GENERIC_WRITE 수 있지만 둘 다일 수는 없습니다.
dwFlags
후속 전송이 발생하는 조건을 지정합니다. 다음 FTP_TRANSFER_* 상수 중에서 선택할 수 있습니다.
FTP_TRANSFER_TYPE_ASCII FTP ASCII(형식 A) 전송 방법을 사용하여 파일을 전송합니다. 컨트롤 및 서식 정보를 로컬 등가물로 변환합니다.
FTP_TRANSFER_TYPE_BINARY 파일은 FTP의 Image(Type I) 전송 방법을 사용하여 데이터를 전송합니다. 파일은 변경 내용 없이 존재하는 그대로 데이터를 전송합니다. 기본 전송 방법입니다.
dwContext
파일을 열기 위한 컨텍스트 식별자입니다. dwContext에 대한 자세한 내용은 비고를 참조하세요.
Return Value
CInternetFile 개체에 대한 포인터입니다.
설명
OpenFile
는 다음과 같은 경우에 사용해야 합니다.
애플리케이션에는 FTP 서버에서 파일로 보내고 만들어야 하지만 해당 데이터가 로컬 파일에 없는 데이터가 있습니다.
OpenFile
에서 파일을 열면 응용프로그램은 cinternetfile::Write를 사용하여 FTP 파일데이터를 서버로 보냅니다.애플리케이션은 서버에서 파일을 검색하고 디스크에 쓰는 대신 애플리케이션 제어 메모리에 배치해야 합니다. 애플리케이션은 파일을 여는 데 사용한
OpenFile
후 CInternetFile::Read를 사용합니다.애플리케이션은 파일 전송을 세부적으로 제어해야 합니다. 예를 들어 애플리케이션은 파일을 다운로드하는 동안 파일 전송 상태의 진행률을 나타내는 진행률 컨트롤을 표시할 수 있습니다.
OpenFile
를 호출하고 CInternetFile::Close
를 호출할 때까지 응용 프로그램은 cinternetfile:: Read, cinternetfile:: Write, CInternetConnection::Close
또는 ccefilefind:: findfile만 호출할 수 있습니다. 동일한 FTP 세션에 대한 다른 FTP 함수에 대한 호출이 실패하고 오류 코드를 FTP_ETRANSFER_IN_PROGRESS 설정합니다.
pstrFileName 매개 변수는 현재 디렉터리를 기준으로 부분적으로 정규화된 파일 이름이거나 정규화될 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. OpenFile
는 디렉터리 이름 구분 기호를 사용하기 전에 적절한 문자로 변환합니다.
dwContext 기본값을 재정의하여 컨텍스트 식별자를 선택한 값으로 설정합니다. 컨텍스트 식별자는 CInternetSession 개체에서 만든 개체의 CFtpConnection
이 특정 작업과 연결됩니다. 이 값은 CInternetSession::OnStatusCallback에 반환되어 식별된 작업에 대한 상태를 제공합니다. 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.
CFtpConnection::PutFile
FTP 서버에 파일을 저장하려면 이 멤버 함수를 호출합니다.
BOOL PutFile(
LPCTSTR pstrLocalFile,
LPCTSTR pstrRemoteFile,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1);
매개 변수
pstrLocalFile
로컬 시스템에서 보낼 파일의 이름을 포함하는 문자열에 대한 포인터입니다.
pstrRemoteFile
FTP 서버에서 만들 파일의 이름을 포함하는 문자열에 대한 포인터입니다.
dwFlags
파일 전송이 발생하는 조건을 지정합니다. OpenFile에 설명된 FTP_TRANSFER_* 상수 중에서 사용할 수 있습니다.
dwContext
파일을 배치하기 위한 컨텍스트 식별자입니다. dwContext에 대한 자세한 내용은 비고를 참조하세요.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
PutFile
는 FTP 서버에 파일을 저장하는 것과 관련된 모든 작업을 처리하는 개략적인 루틴입니다. 데이터만 보내거나 파일 전송을 더 자세히 제어해야 하는 애플리케이션은 OpenFile 및 CInternetFile::Write를 사용해야 합니다.
dwContext
기본값을 재정의하여 컨텍스트 식별자를 설정한 값으로 설정합니다. 컨텍스트 식별자는 CInternetSession 개체에서 만든 개체의 CFtpConnection
이 특정 작업과 연결됩니다. 이 값은 CInternetSession::OnStatusCallback에 반환되어 식별된 작업에 대한 상태를 제공합니다. 컨텍스트 식별자에 대한 자세한 내용은 Internet First Steps: WinInet 문서를 참조하세요.
CFtpConnection::Remove
이 멤버 함수를 호출하여 연결된 서버에서 지정된 파일을 삭제합니다.
BOOL Remove(LPCTSTR pstrFileName);
매개 변수
pstrFileName
제거할 파일 이름을 포함하는 문자열에 대한 포인터입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
pstrFileName 매개 변수는 현재 디렉터리를 기준으로 부분적으로 정규화된 파일 이름이거나 정규화될 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. 이 함수는 Remove
사용되기 전에 디렉터리 이름 구분 기호를 적절한 문자로 변환합니다.
CFtpConnection::RemoveDirectory
이 멤버 함수를 호출하여 연결된 서버에서 지정된 디렉터리를 제거합니다.
BOOL RemoveDirectory(LPCTSTR pstrDirName);
매개 변수
pstrDirName
제거할 디렉터리가 포함된 문자열에 대한 포인터입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
GetCurrentDirectory를 사용하여 서버의 현재 작업 디렉터리를 확인합니다. 원격 시스템이 사용자를 루트 디렉터리에 연결한 것으로 가정하지 마세요.
pstrDirName 매개 변수는 현재 디렉터리를 기준으로 부분적으로 또는 정규화된 파일 이름일 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. RemoveDirectory
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
CFtpConnection::Rename
이 멤버 함수를 호출하여 연결된 서버에서 지정된 파일의 이름을 바꿉니다.
BOOL Rename(
LPCTSTR pstrExisting,
LPCTSTR pstrNew);
매개 변수
pstrExisting
이름을 바꿀 파일의 현재 이름을 포함하는 문자열에 대한 포인터입니다.
pstrNew
파일의 새 이름을 포함하는 문자열에 대한 포인터입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
pstrExisting 및 pstrNew 매개 변수는 현재 디렉터리를 기준으로 부분적으로 정규화된 파일 이름이거나 정규화될 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. Rename
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
CFtpConnection::SetCurrentDirectory
FTP 서버의 다른 디렉터리로 변경하려면 이 멤버 함수를 호출합니다.
BOOL SetCurrentDirectory(LPCTSTR pstrDirName);
매개 변수
pstrDirName
디렉터리의 이름을 포함하는 문자열에 대한 포인터입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다. 호출이 실패하면 Win32 함수 GetLastError 를 호출하여 오류의 원인을 확인할 수 있습니다.
설명
pstrDirName 매개 변수는 현재 디렉터리를 기준으로 부분적으로 또는 정규화된 파일 이름일 수 있습니다. 백슬래시(\) 또는 슬래시(/)를 두 이름에 대한 디렉터리 구분 기호로 사용할 수 있습니다. SetCurrentDirectory
는 디렉터리 이름 구분 기호를 사용되기 전에 적절한 문자로 변환합니다.
GetCurrentDirectory를 사용하여 FTP 서버의 현재 작업 디렉터리를 확인합니다. 원격 시스템이 사용자를 루트 디렉터리에 연결한 것으로 가정하지 마세요.
참고 항목
CInternetConnection 클래스
계층 구조 차트
CInternetConnection 클래스
CInternetSession 클래스