Name

Description

$err = VMCreateDirectoryInGuest($vmHandle,
                                $pathName,
                                $propertyListHandle);

This function creates a directory in the guest operating system.

Parameters

vmHandle

Identifies a virtual machine. Call VMOpen() to create a virtual machine handle.

pathName

The path to the directory to be created.

propertyListHandle

Must be VIX_INVALID_HANDLE.

Return Value

Remarks

• You must call VMLoginInGuest() 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 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

Requirements

use VMware::Vix::Simple;
use VMware::Vix::API::Constants;