MSProtectedData protectedDataWithProtectedFile:completionBlock method

Asynchronously creates and returns a protected file data object that can be used to read (and decrypt) data from the specified file, which is protected to Microsoft Protected File format.

Signature

+ (MSAsyncControl *)protectedDataWithProtectedFile:(NSString *)path
                                            userId:(NSString *)userId
                            authenticationCallback:(id<MSAuthenticationCallback>)authenticationCallback
                                   consentCallback:(id<MSConsentCallback>)consentCallback
                                           options:(MSPolicyAcquisitionOptions)options
                                   completionBlock:(void(^)(MSProtectedData *data, NSError *error))completionBlock;

Parameters

Name	Datatype	Notes
path	NSString *	Required. The absolute path of the protected file from which to read data.
userId	NSString *
authenticationCallback	id<[MSAuthenticationCallback](msauthenticationcallback-protocol-objc.md)>
consentCallback	id<[MSConsentCallback](./msconsentcallback-protocol-objc.md)>
options	[MSPolicyAcquisitionOptions](mspolicyacquisitionoptions-enum-objc.md)
completionBlock	void(^)([MSProtectedData](msprotecteddata-interface-objc.md) *data, NSError *error))	Required. Called when the method is completed with the following parameters: data The protected file data object. error If there is an error creating the data object, contains an NSError object that describes the problem. [!Note] If the user cancels the operation, both the data and error parameters will be NIL.

Returns

Returns an MSAsyncControl object allowing you to cancel asynchronous SDK operations including closing all opened UI.

Defined in

MSProtectedData.h

Supported Platforms

Minimum supported OS versions	iOS 7.0 and OS X 10.8

Remarks

The userPolicy property is set based on the policy that applies to the specified file.