<doc>
	<legacy_id></legacy_id>
	<name>protectedDataWillBecomeUnavailable</name>
	<type>message</type>

	<syntax>
		<example>protectedDataWillBecomeUnavailable</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent when the device is locked and protected data files will become unavailable.</summary>

	<examples>
<example><p>on protectedDataWillBecomeUnavailable</p><p>   -- Disconnect from databases</p><p>   -- Close file handles</p><p>end protectedDataWillBecomeUnavailable</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="protectedDataDidBecomeAvailable">protectedDataDidBecomeAvailable Message</message>
	</references>

	<description>
	<overview>Handle the <b>protectedDataWillBecomeUnavailable</b> message if you have open file handles related to files that have been protected using the <function tag="iphoneFileDataProtection">iphoneFileDataProtection</function> function. These handles should be closed. Connections to sqlite databases should also be closed where the database file has been set to protected.</overview>

		<parameters>
		</parameters>

	<value></value>
	<comments>The <b>protectedDataWillBecomeUnavailable</b> message is sent to the current card of the default stack when the device is locked.</comments>
	</description>
</doc>