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

	<syntax>
		<example>iphoneFileDataProtection <i>filename</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Retrieves the data protection level of a file.</summary>

	<examples>
<example><p>if iphoneFileDataProtection() is &quot;none&quot; then</p><p>   iphoneSetFileDataProtection tFile, &quot;complete&quot;</p><p>end if</p></example>
	</examples>

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

	<objects>
	</objects>

	<platforms>
		<ios/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>User Interaction</category>
	</classification>

	<references>
		<function tag="iphoneDoNotBackupFile">iphoneDoNotBackupFile Function</function>
		<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>iphoneFileDataProtection</b> function to query the current level of protection of a particular file set using the command <command tag="iphoneSetFileDataProtection">iphoneSetFileDataProtection</command>. </overview>

		<parameters>
<parameter>
<name>filename</name>
<description>A string containing the path to the file. </description>
</parameter>		</parameters>

	<value>The <b>iphoneFileDataProtection </b>function returns a string containing one of the following:<p>* &quot;none&quot;</p><p>* &quot;complete&quot;</p><p>* &quot;complete unless open&quot; (iOS 5 and later only)</p><p>* &quot;complete until first user authentication&quot; (iOS 5 and later only)</p></value>
	<comments></comments>
	</description>
</doc>