<doc>
	<legacy_id></legacy_id>
	<name>iphoneDoNotBackupFile</name>
	<type>function</type>

	<syntax>
		<example>iphoneDoNotBackupFile( <i>filename )</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Returns a boolean value specifying whether or not the given file has been flagged to prevent backup.</summary>

	<examples>
<example>get iphoneDoNotBackupFile(tMyFile)</example>
<example>put iphoneDoNotBackupFile(specialFolderPath(&quot;documents&quot;) &amp; &quot;/appointments.txt&quot;) into tAppointmentsFlagged</example>
	</examples>

	<history>
		<introduced version="5.5.1">Added</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="iphoneFileDataProtection">iphoneFileDataProtection Function</function>
		<command tag="iphoneSetDoNotBackupFile">iphoneSetDoNotBackupFile Command</command>
		<command tag="iphoneSetFileDataProtection">iphoneSetFileDataProtection Command</command>
		<message tag="protectedDataWillBecomeUnavailable">protectedDataWillBecomeUnavailable Message</message>
		<message tag="protectedDataDidBecomeAvailable">protectedDataDidBecomeAvailable Message</message>
	</references>

	<description>
	<overview>Use the <b>iphoneDoNotBackupFile</b> function to determine whether the given file has been flagged to prevent backup</overview>

		<parameters>
  <parameter>
    <name>filename</name>
    <description>The fulle path to the flagged file</description>
  </parameter>		</parameters>

	<value>true - the file has been flagged to prevent backup to the Cloud.<p>false - the file has not been flagged to prevent backup to the Cloud.</p></value>
	<comments>The <b>iphoneDoNotBackupFile</b> function determines whether or not the given file has been flagged to prevent backup to the Cloud.<p></p><p>The <b>iphoneDoNotBackupFile</b> function retirms the value of the file&apos;s &quot;do not backup&quot; flag.</p></comments>
	</description>
</doc>