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);

ส่งกลับค่า

ไม่ใช่ศูนย์ถ้าสำเร็จ 0 อื่น ถ้าการเรียกล้มเหลว ฟังก์ชัน Win32 GetLastErrorอาจถูกเรียกเมื่อต้องการระบุสาเหตุของข้อผิดพลาด?

พารามิเตอร์

pstrRemoteFile

ตัวชี้ไปยังสายสิ้นสุดด้วยค่า null ที่ประกอบด้วยชื่อของแฟ้มที่จะดึงจากเซิร์ฟเวอร์ FTP?

pstrLocalFile

ตัวชี้ไปยังสายสิ้นสุดด้วยค่า null ที่ประกอบด้วยชื่อของแฟ้มสร้างในระบบภายในเครื่อง?

bFailIfExists

บ่งชี้ว่า ชื่อแฟ้มอาจถูกใช้ไปแล้ว โดยแฟ้มที่มีอยู่ ถ้าชื่อแฟ้มเฉพาะเครื่องมีอยู่แล้ว และพารามิเตอร์นี้เป็นจริง GetFileล้มเหลว มิฉะนั้นGetFileจะลบสำเนาของแฟ้มที่มีอยู่?

dwAttributes

บ่งชี้ว่า แอตทริบิวต์ของแฟ้ม นี้จะเป็นการรวมกันของค่าต่อไปนี้ FILE_ATTRIBUTE_ * สถานะ?

• FILE_ATTRIBUTE_ARCHIVEnbsp  แฟ้มเก็บถาวรแฟ้มที่มีอยู่ โปรแกรมประยุกต์ที่ใช้คุณลักษณะนี้เพื่อทำเครื่องหมายแฟ้มสำหรับการสำรองข้อมูลหรือการเอาออก(&N)?
  
  
• FILE_ATTRIBUTE_COMPRESSEDnbsp  แฟ้มหรือไดเรกทอรีถูกบีบอัด แฟ้ม การบีบอัดหมายความ ว่า ข้อมูลในแฟ้มทั้งหมดจะถูกบีบอัด สำหรับไดเรกทอรี บีบอัดเป็นค่าเริ่มต้นสำหรับแฟ้มที่สร้างขึ้นใหม่และ subdirectories(&N)?
  
  
• FILE_ATTRIBUTE_DIRECTORYnbsp  แฟ้มเป็นไดเรกทอรี(&N)?
  
  
• FILE_ATTRIBUTE_NORMALnbsp  แฟ้มไม่มีคุณลักษณะอื่น ๆ ที่กำหนดได้ แอตทริบิวต์นี้ถูกต้องเท่านั้นถ้าใช้เพียงลำพัง แอตทริบิวต์แฟ้มอื่น ๆ ทั้งหมดแทน FILE_ATTRIBUTE_NORMAL(&N):
  
  
• FILE_ATTRIBUTE_HIDDENnbsp  แฟ้มถูกซ่อนไว้ มันจะไม่รวมในรายการไดเรกทอรีธรรมดาตัว(&N)?
  
  
• FILE_ATTRIBUTE_READONLYnbsp  แฟ้มแบบอ่านอย่างเดียว แอปพลิเคชันสามารถอ่านไฟล์ แต่ไม่สามารถเขียนไปนั้น หรือลบ(&N)?
  
  
• FILE_ATTRIBUTE_SYSTEMnbsp  แฟ้มหนึ่ง หรือใช้แบบเอกสิทธิ์เฉพาะบุคคล โดยระบบปฏิบัติการ(&N)?
  
  
• FILE_ATTRIBUTE_TEMPORARYnbsp  แฟ้มกำลังถูกใช้สำหรับเก็บข้อมูลชั่วคราว แอปพลิเคชันควรเขียนไปยังแฟ้มเท่านั้นถ้าจำเป็นจริง ๆ ส่วนใหญ่ของแฟ้มข้อมูลยังคงอยู่ในหน่วยความจำโดยไม่มีการลบค่าการสื่อได้เนื่องจากแฟ้มในเร็ว ๆ นี้จะถูกลบออก(&N)?

dwFlags

ระบุเงื่อนไขที่เกิดการโอนย้าย พารามิเตอร์นี้สามารถมีค่าdwFlagsอธิบายไว้ใน FtpGetFileในPlatform SDK?

dwContext

ตัวระบุบริบทสำหรับการเรียกคืนแฟ้ม ดูหมายเหตุสำหรับข้อมูลเพิ่มเติมเกี่ยวกับdwContext?

หมายเหตุ

เรียกฟังก์ชันนี้สมาชิกจะได้รับแฟ้มจากเซิร์ฟเวอร์ FTP และจัดเก็บไว้บนเครื่อง?

GetFileเป็นรูทีนพื้นฐานที่จัดการกับค่าใช้จ่ายในการเชื่อมโยงกับการอ่านแฟ้มจากเซิร์ฟเวอร์ FTP และจัดเก็บในเครื่องทั้งหมด โปรแกรมประยุกต์ที่เรียกเฉพาะแฟ้มข้อมูล หรือที่ต้องการโอนย้ายแฟ้มควบคุมปิด ควรใช้OpenFileและCInternetFile::Readแทน?

ถ้าdwFlags FILE_TRANSFER_TYPE_ASCII แปลแฟ้มข้อมูลยังแปลงควบคุมและจัดรูปแบบอักขระให้เทียบเท่าของ Windows การโอนย้ายค่าเริ่มต้นคือ โหมดไบนารี ที่แฟ้มถูกดาวน์โหลดในรูปแบบเดียวกันขณะนั้นถูกเก็บบนเซิร์ฟเวอร์?

ทั้งpstrRemoteFileและpstrLocalFileสามารถเป็นได้ทั้งชื่อแฟ้มบางส่วนที่มีคุณสมบัติเทียบกับไดเรกทอรีปัจจุบัน หรือมีคุณสมบัติครบถ้วน เครื่องหมายทับขวา (\) หรือทับ (/) สามารถใช้เป็นตัวแยกไดเรกทอรีสำหรับชื่อใด GetFileแปลตัวคั่นชื่อไดเรกทอรีอักขระเหมาะสมก่อนการใช้?

แทนที่ค่าเริ่มต้นdwContextเพื่อตั้งค่ารหัสบริบทค่าตัวเลือกของคุณ ตัวระบุเนื้อหาเกี่ยวข้องกับการดำเนินการนี้เฉพาะของวัตถุCFtpConnectionสร้างขึ้น โดยวัตถุของCInternetSession ค่าถูกส่งกลับไปที่CInternetSession::OnStatusCallbackเพื่อให้สถานะในการดำเนินการที่ให้ระบุ ดูบทความ ขั้นตอนแรกของอินเทอร์เน็ต: WinInetสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุบริบท?

ภาพรวม CFtpConnection |nbsp สมาชิกของคลาส| แผนภูมิของลำดับชั้น(&N)

ดูเพิ่มเติมnbspCInternetConnection(&N)