Name
VixVM_CreateDirectoryInGuest
Description
VixHandle
VixVM_CreateDirectoryInGuest(VixHandle vmHandle,
const char *pathName,
VixHandle propertyListHandle,
VixEventProc *callbackProc,
void *clientData);
This function creates a directory in the guest operating system.
Parameters
- vmHandle
-
Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
- pathName
-
The path to the directory to be created.
- propertyListHandle
-
Must be VIX_INVALID_HANDLE.
- callbackProc
-
A callback function that will be invoked when the
operation is complete.
- clientData
-
A parameter that will be passed to the callbackProc function.
Return Value
VixHandle. A job handle that describes the state of this asynchronous operation.
Remarks
- You must call VixVM_LoginInGuest() before calling this function.
- If the parent directories for the specified path do not exist, this function
will create them.
- If the directory already exists, the error associated with the job handle
will be set to VIX_E_FILE_ALREADY_EXISTS.
- Only absolute paths should be used for files in the guest; the resolution of
relative paths is not specified.
Side Effects
None.
Requirements
vix.h, since Workstation 6.0
Minimum Supported Guest OS: Microsoft Windows NT Series, Linux