Changeset 42385 in vbox for trunk/include/VBox/com

Timestamp:

Jul 25, 2012 11:52:31 AM (12 years ago)

Author:

vboxsync

Message:

Main/glue: Add a flag to GetVBoxUserHomeDirectory to disable creating the VirtualBox settings directory automatically

File:

• trunk/include/VBox/com/com.h (modified) (1 diff)

trunk/include/VBox/com/com.h

@@ -73 +73 @@
  *  this method will return VERR_BUFFER_OVERFLOW.
  *
- *  @param aDir     Buffer to store the directory string in UTF-8 encoding.
- *  @param aDirLen  Length of the supplied buffer including space for the
- *                  terminating null character, in bytes.
- *  @return         VBox status code.
+ *  @param aDir        Buffer to store the directory string in UTF-8 encoding.
+ *  @param aDirLen     Length of the supplied buffer including space for the
+ *                     terminating null character, in bytes.
+ *  @param fCreateDir  Flag whether to create the returned directory on success if it
+ *                     doesn't exist.
+ *  @return            VBox status code.
  */
-int GetVBoxUserHomeDirectory(char *aDir, size_t aDirLen);
+int GetVBoxUserHomeDirectory(char *aDir, size_t aDirLen, bool fCreateDir = true);
 
 /**