LoadFromFile Method

Copies contents of a file-based vault into the in-memory vault.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int LoadFromFile(const char* lpszFileName);

Unicode (Windows)
INT LoadFromFile(LPCWSTR lpszFileName);

- (void)loadFromFile:(NSString*)fileName;

#define MID_CBMEMDRIVE_LOADFROMFILE 60

CBFSSTORAGE_EXTERNAL int CBFSSTORAGE_CALL CBFSStorage_CBMemDrive_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method loads the contents of the vault, specified by FileName, into the class.

If the in-memory vault is not opened, LoadFromFileopens an in-memory vault. If the in-memory vault is already opened, it is closed by this method.

If the vault is encrypted, then before calling LoadFromFile, the application should set proper values to VaultEncryption and VaultPassword properties.

Note: This method can only be called when Active is true, and cannot be called within events.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)