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.
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
Index