다음을 통해 공유


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
    전송에서 발생 하는 조건을 지정 합니다.수 있습니다이 매개 변수는 dwFlags 값에서 설명 FtpGetFile 에 Windows SDK.

  • dwContext
    파일 검색에 대 한 컨텍스트 식별자입니다.참조 비고 에 대 한 자세한 내용은 dwContext.

반환 값

성공 하면 0이 아닌. 그렇지 않으면 0입니다.Win32 함수 호출이 실패 하면 GetLastError 오류 원인을 호출 될 수 있습니다.

설명

GetFileFTP 서버에서 파일을 읽기 및 로컬로 저장 하기와 관련 된 오버 헤드를 처리 하는 높은 수준의 루틴이입니다.만 검색할 파일 데이터 또는 파일 전송을 통해 닫기 컨트롤 필요한 응용 프로그램을 사용 해야 OpenFileCInternetFile::Read 대신 합니다.

경우 dwFlags FILE_TRANSFER_TYPE_ASCII, 파일 데이터의 변환 변환 제어 이기도 한 문자에 해당 하는 Windows.기본 전송 이진 모드, 서버에 저장 된 동일한 형식으로 파일이 다운로드 된 경우

둘 다 pstrRemoteFile 및 pstrLocalFile 두 부분적으로 정규화 된 파일 이름이 현재 디렉터리에 상대적 이거나 정규화 된.이름 중 하나를 디렉터리 구분 기호로 백슬래시 (\) 또는 슬래시 (/)를 사용할 수 있습니다.GetFile사용 하기 전에 디렉터리 이름을 구분 하려면 적절 한 문자를 변환 합니다.

재정의 dwContext 기본 컨텍스트 식별자를 사용자가 선택한 값으로 설정 합니다.컨텍스트 식별자를이 특정 작업과 관련 된는 CFtpConnection 만든 개체의 CInternetSession 개체입니다.값이 반환 됩니다 CInternetSession::OnStatusCallback 상태를 식별 된 작업을 제공 합니다.참고 인터넷 첫 번째 단계: WinInet 컨텍스트 식별자에 대 한 자세한 내용은.

요구 사항

헤더: afxinet.h

참고 항목

참조

CFtpConnection 클래스

계층 구조 차트

CInternetConnection 클래스