CFtpConnection::GetFile

bool GetFile (lpctstr pstrRemoteFile, lpctstr pstrLocalFile, bool bFailIfExists = true, dword dwAttributes FILE_ATTRIBUTE_NORMAL, dword = dwFlags FTP_TRANSFER_TYPE_BINARY, dword = dwContext = 1);

Dönüş değeri

Sıfır başarılı olursa; Aksi halde 0. Çağrı başarısız olursa, Win32 işlevi GetLastError denilen hatanın nedenini belirlemek için.

Parametreleri

pstrRemoteFile

Ftp sunucusundan almak için bir dosyanın adını içeren bir boş sonlandırılmış dize işaretçisi.

pstrLocalFile

Yerel sistem üzerindeki oluşturulacak dosyanın adını içeren bir boş sonlandırılmış dize işaretçisi.

bFailIfExists

Dosya adı zaten varolan dosyası tarafından kullanılabilir olup olmadığını gösterir. Yerel dosya adı zaten var ve bu parametre trueise, GetFile başarısız olur. Aksi takdirde, dosya kopyası GetFile silecek.

dwAttributes

Dosya özniteliklerini belirtir. Bu aşağıdaki bayrakları FILE_ATTRIBUTE_ * herhangi bir birleşimi olabilir.

• FILE_ATTRIBUTE_ARCHIVE   Arşiv dosyası dosyasıdır. Uygulamaları, dosyaları yedekleme veya kaldırılması için işaretlemek için bu özniteliği kullanın.
  
  
• FILE_ATTRIBUTE_COMPRESSED   Dosya veya dizin sıkıştırılmış. Bir dosya için sıkıştırma sıkıştırılmış dosyadaki tüm verilerin anlamına gelir. Bir dizin için sıkıştırma yeni oluşturulan dosyaları ve alt dizinleri için varsayılan değerdir.
  
  
• FILE_ATTRIBUTE_DIRECTORY   Dosyanın bir dizin olup.
  
  
• FILE_ATTRIBUTE_&NORMALnbsp;  Dosya ayarlamak niteliklerine sahip. Bu özellik, yalnızca tek başına kullanılması durumunda geçerlidir. Tüm diğer dosya özniteliklerini FILE_ATTRIBUTE_NORMAL geçersiz kılar.:
  
  
• FILE_ATTRIBUTE_HIDDE&Nnbsp;  Dosya gizlidir. Bir sıradan dizin listesi dahil değil mi.
  
  
• FILE_ATTRIBUTE_READO&NLYnbsp;  Dosya salt okunur. Uygulamalar dosyayı okuyabilir ama cant yazma veya Sil.
  
  
• FILE_ATTRIBUTE_SYSTEM   Dosya parçası veya yalnızca işletim sistemi tarafından kullanılan.
  
  
• FILE_ATTRIBUTE_TEMPORARY   Dosyayı geçici depolama için kullanılır. Uygulamaları, sadece kesinlikle gerekli eğer dosyaya yazmak gerekir. Verilerinin çoğunu hala bellekte dosya yakında silinecektir çünkü medya olmadan boşaltılan.

dwFlags

Transfer altında gerçekleştiği koşulları belirtir. Bu parametre tanımlanan dwFlags değerler olabilir FtpGetFile Platform sdk.

dwContext

Dosya alma bağlamını tanımlayıcısı. DwContext hakkında daha fazla bilgi için Açıklamalar ' a bakın.

Açıklamalar

Bu üye işlevi ftp sunucusundan bir dosya almak ve yerel makine üzerinde depolamak için çağrı.

GetFile yükü bir ftp sunucusundan bir dosya okuma ve yerel olarak depolanması ile ilgili tüm işler üst düzey bir alışkanlıktır. Uygulamalar, yalnızca dosya veri almak veya bu dosya aktarımı yakın kontrol gerektiren, OpenFile ve CInternetFile::Read kullanmalısınız.

DwFlags FILE_TRANSFER_TYPE_ASCII ise, Çeviri dosyası veri de kontrol ve biçimlendirme karakterleri Windows eşdeğerleri dönüştürür. Varsayılan ikili mod, sunucuda depolanan dosya aynı biçimde nerede karşıdan yüklenir Transfer'dir.

Hem pstrRemoteFile hem de pstrLocalFile tam veya göreli olarak geçerli dizin ya da kısmen nitelenmiş dosya adları olabilir. Bir ters eğik çizgi (\) veya eğik çizgi (/), ya da adı dizin ayracı olarak kullanılabilir. Onlar kullanılmadan önce GetFile dizin adı ayırıcıları uygun karakterlere çevirir.

DwContext varsayılan bağlam tanımlayıcı sizin seçtiğiniz bir değere ayarlamak için geçersiz. İçerik, bu işlemi kendi CInternetSession nesnesi tarafından oluşturulan CFtpConnection nesnesi ile ilişkilendirilmiş bir tanımlayıcıdır. Değer CInternetSession::OnStatusCallback ile tanımlanır operasyon durumu sağlamak için döndürülür. Makaleye bakın Internet ilk adımlar: WinINet bağlam kimliği hakkında daha fazla bilgi.

CFtpConnection genel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi

Ayrıca bkz: CInternetConnection