CFtpConnection::OpenFile

Makale
02/26/2013

Okuma veya yazma için bir ftp sunucusu üzerinde bulunan bir dosyayı açmak için bu üye işlevini çağırın.

CInternetFile* OpenFile(
   LPCTSTR pstrFileName,
   DWORD dwAccess = GENERIC_READ,
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
   DWORD_PTR dwContext = 1 
);

Parametreler

pstrFileName
Açılacak dosyanın adını içeren bir dize için bir işaretçi.
dwAccess
Dosyayı nasıl erişileceğini belirler.GENERIC_READ veya GENERIC_WRITE ancak ikisini birden olabilir.
dwFlags
Hangi koşullarda izleyen aktarımları koşulları belirtir.Bu, aşağıdaki ftp_transfer_ * sabitlerinden biri olabilir:
- FTP_TRANSFER_TYPE_ASCII dosyasını ftp ASCII (tür a) aktarım yöntemini kullanarak aktarır.Denetim dönüştürür ve biçimlendirme bilgilerini yerel eşdeğerleri için.
- FTP_TRANSFER_TYPE_BINARY dosya ftp's görüntü (Tip ı) aktarım yöntemini kullanarak veri aktarımı yapar.Dosya aktarımları verileri tam olarak aynı şekilde, herhangi bir değişiklik var.Bu varsayılan aktarım yöntemidir.
dwContext
Dosyayı açmak için bağlam tanıtıcısı.Bkz: Açıklamalar hakkında daha fazla bilgi için dwContext.

Dönüş Değeri

Bir işaretçi bir CInternetFile nesnesi.

Notlar

OpenFileAşağıdaki durumlarda kullanılır:

Uygulama verileri, yerel bir dosyada değil ancak bu, gönderilen ve ftp sunucusu üzerindeki bir dosya olarak oluşturulan gereken veri yok.Bir kez OpenFile uygulamasını kullanan bir dosyayı açar CInternetFile::Write sunucuya ftp dosya verilerini göndermek için.
Uygulama, bir dosya sunucusundan almak ve diske yazmak yerine uygulama kontrollü bellek içine yerleştirin.Uygulamanın kullandığı CInternetFile::Read kullandıktan sonra OpenFile dosyasını açın.
Bir uygulamayı daha iyi düzeyde dosya aktarımı üzerinden denetimi gerekiyor.Örneğin, uygulama bir ilerleme durumunu görüntülemek isteyebilirsiniz denetim bir dosyayı karşıdan yüklerken dosya aktarım durumu ilerlemesini gösterir.

Sonra arama OpenFile ve arama kadar CInternetConnection::Close, uygulamanın yalnızca çağırabileceği CInternetFile::Read, CInternetFile::Write, CInternetConnection::Close, ya da CFtpFileFind::FindFile.Diğer ftp işlevleri aynı ftp oturumu için yapılan çağrı başarısız ve hata kodu FTP_ETRANSFER_IN_PROGRESS için ayarlayın.

pstrFileName Parametresi, dosya ya da kısmen nitelenmiş adı geçerli dizine göreli veya tam olabilir.Ters eğik çizgi (\) veya eğik çizgi (/) ya da ad için dizin ayırıcı olarak kullanılabilir.OpenFilekullanmadan önce dizin adı ayırıcılar uygun karakterlere çevirir.

Geçersiz kılma dwContext varsayılan bağlam tanıtıcısı bir değere ayarlamak için.İçerik tanıtıcısı belirli bu işlemle ilişkili CFtpConnection tarafından oluşturulan nesne kendi CInternetSession nesnesi.İçin döndürülen değer CInternetSession::OnStatusCallback ile onu tanımlanmıştır üzerinde işlem durumu sağlamak için.Makaleye bakın Internet ilk adımlar: WinINet içerik tanıtıcısı hakkında daha fazla bilgi.