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.

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