# 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

Copyright (C) 2007-2018 VMware, Inc. All rights reserved.