CreateDirectory Method

Creates a new directory in the vault.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int CreateDirectory(const char* lpszDirectory, int bCreateParents);

Unicode (Windows)
INT CreateDirectory(LPCWSTR lpszDirectory, BOOL bCreateParents);

- (void)createDirectory:(NSString*)directory :(BOOL)createParents;

#define MID_CBVAULT_CREATEDIRECTORY 11

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

Remarks

This method creates a new directory in the vault at the path specified by Directory.

The value passed for Directory must be a vault-local absolute path.

The CreateParents parameter specifies whether non-existent parent directories in the specified path should be created as well. If this parameter is false, and one or more parent directories are missing, this method fails with an error.

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.)