Virtual Disk API Programming Guide - Documentation - VMware

Virtual Disk Programming Guide
Disk Volume Information
The VixVolumeInfo structure encapsulates the following information:
Type of the volume, VixVolumeType, one of the following:
Basic partition.
GPT – GUID Partition Table. However, VixMntapi does not support GPT partitions.
Dynamic volume, including Logical Disk Manager (LDM).
LVM – Logical Volume Manager disk storage.
Whether the guest volume is mounted on the proxy.
Path to the volume mount point on the proxy, or NULL if the volume is not mounted.
On Windows, numGuestMountPoints is the number of times a basic volume is mapped to a drive letter,
or 0 if the volume is not mounted. IDE and boot disk come first. Unimplemented on Linux.
Mount points for the volume in the guest.
Function Calls
To obtain these functions, load the vixMntapi library separately from the vixDiskLib library. On Windows,
compile with the vixMntapi.lib library so your program can load the vixMntapi.dll runtime.
These calls can be used to mount and read Windows virtual disks on Windows hosts (with at least one NTFS
volume) or Linux virtual disks on Linux hosts. Cross‐mounting is restricted, though it is possible to mount a
virtual disk with a mix of formats, if the mounted partition was formatted with Windows.
IMPORTANT You should run only one vixMntapi program at a time on a virtual machine, to avoid conflict
between registry hives. See “Multithreading Considerations” on page 41 for advice on worker threads.
The remainder of this section lists the available function calls in the vixMntapi library. Under parameters, [in]
indicates input parameters, and [out] indicates output parameters. All functions that return vixError return
VIX_OK on success, otherwise a suitable VIX error code.
VixMntapi_Init()
Initializes the library. Similar to VixDiskLib_InitEx – see “Initialize Virtual Disk API” on page 35.
VixError
VixMntapi_Init(uint32 majorVersion,
uint32 minorVersion,
VixDiskLibGenericLogFunc *log,
VixDiskLibGenericLogFunc *warn,
VixDiskLibGenericLogFunc *panic,
const char *libDir,
const char *configFile);
Parameters:
majorVersion [in] VixMntapi major version number, currently must be 1 (one).
minorVersion [in] VixMntapi minor version number, currently must be 0 (zero).
log [in] Callback function to write log messages.
warn [in] Callback function to write warning messages.
panic [in] Callback function to report fatal errors.
libDir [in] and configFile [in] as for VixDiskLib_InitEx(), allowing you to tmpDirectory.
VixMntapi_Exit()
Cleans up the VixMntapi library.
void VixMntapi_Exit();
88 VMware, Inc.