Name

Description

PHT_ACCESS_RIGHTS

The PHT_ACCESS_RIGHTS handle is a container containing the virtual machine access rights information.

PHT_BOOT_DEVICE

The PHT_BOOT_DEVICE handle is used to manage boot devices in a virtual machine. The handle is obtained by calling the PrlVmCfg_GetBootDev or the PrlVmCfg_CreateBootDev function. The first function is used to obtain a handle to an existing device in the boot priority list. The second function creates a new handle and is used to add a new device to the list.

PHT_DISP_CONFIG

The PHT_DISP_CONFIG handle is used to manage Parallels Service preferences. The handle is obtained by calling the PrlSrv_GetCommonPrefs function.

PHT_DISP_NET_ADAPTER

The PHT_DISP_NET_ADAPTER handle is used to manage virtual network adapters. The handle is obtained by calling the PrlDispCfg_GetDispNet or the PrlDispCfg_CreateDispNet function.

PHT_EVENT

The PHT_EVENT handle is a container that can contain information about system events or extended error information in asynchronous functions.

PHT_EVENT_PARAMETER

The PHT_EVENT_PARAMETER handle is a container that contains system event parameter data. The handle is obtained by calling the PrlEvent_GetParam function.

PHT_FOUND_VM_INFO

The PHT_FOUND_VM_INFO handle is a container that contains information about a virtual machine as a result of a search operation. The handle is obtained by calling the PrlSrv_StartSearchVms function.

PHT_HW_GENERIC_DEVICE

PHT_HW_GENERIC_DEVICE is a base object that provides methods for getting information about physical devices on the host machine.

PHT_HW_HARD_DISK

The PHT_HW_HARD_DISK handle provides methods for getting the information about a physical hard disk on the host machine. The handle is obtained by calling the PrlSrvCfg_GetHardDisk function. The handle is derived from PHT_HW_GENERIC_DEVICE , which provides additional device management methods.

PHT_HW_HARD_DISK_PARTITION

The PHT_HW_HARD_DISK_PARTITION handle provides methods for getting the information about a physical hard disk partition. The handle is obtained by calling the PrlSrvCfgHdd_GetPart function. The handle is derived from PHT_HW_GENERIC_DEVICEt, which provides additional device management methods.

PHT_HW_NET_ADAPTER

The PHT_HW_NET_ADAPTER handle provides methods for getting the information about a network adapter on the host or in a virtual machine as seen by the guest operating system. The handle is obtained by calling the PrlSrvCfg_GetNetAdapter function. The handle is derived from the PHT_HW_GENERIC_DEVICE handle, which provides additional device management methods.

PHT_JOB

The PHT_JOB handle provides methods for managing asynchronous operations.

PHT_LICENSE

The PHT_LICENSE handle provides methods for retrieving the Parallels license information. The handle is obtained from the PHT_JOB object returned by the PrlSrv_GetLicenseInfo function.

PHT_LOGIN_RESPONSE

The PHT_LOGIN_RESPONSE handle is a container that contains information pertinent to a successful Parallels Service login operation. The handle is obtained from the PHT_JOB object returned by the PrlSrv_Login or the PrlSrv_LoginLocal function.

PHT_NET_SERVICE_STATUS

The PHT_NET_SERVICE_STATUS handle provides methods for retrieving the Parallels Service network status information. A handle to it is obtained from the PHT_JOB object returned by the PrlSrv_GetNetServiceStatus function.

PHT_PORT_FORWARDING

The PHT_PORT_FORWARDING handle provides access to the Port Forwarding functionality. Using this functionality, you can redirect all incoming data from a specific TCP port on the host machine to a specified port on a specified virtual machine.

PHT_REMOTE_FILESYSTEM_ENTRY

The PHT_REMOTE_FILESYSTEM_ENTRY handle, together with the PHT_REMOTE_FILESYSTEM_INFO handle, is used to obtain information about the file system on the host machine.The PHT_REMOTE_FILESYSTEM_ENTRY handle is a container that contains information about a single file system entry. The handle is obtained by making the PrlFsInfo_GetChildEntry call.

PHT_REMOTE_FILESYSTEM_INFO

The PHT_REMOTE_FILESYSTEM_INFO handle is a container that contains information about a file system entry and its immediate child elements (e.g. directory/files). The handle is obtained from a PHT_JOB object returned by the PrlSrv_FsGetDirEntries or the PrlSrv_FsGetDiskList function.

PHT_RESULT

The PHT_RESULT handle is a container that contains results of an asynchronous operation. The handle is obtained from the PHT_JOB object returned by the asynchronous function.

PHT_RUNNING_TASK

The PHT_RUNNING_TASK handle is used to recover from the lost Parallels Service connection. It allows to attach to an existing task that was started in the previous session and is still running inside the Parallels Service. The handle is obtained using the PrlLoginResponse_GetRunningTaskByIndex function. Only a limited number of tasks is supported by this functionality. They are defined in the PRL_RUNNING_TASK_TYPE_ENUM enumeration. For more information, please also see the PrlSrv_AttachToLostTask function.

PHT_SERVER

At the root of the Parallels API class hierarchy is a handle of type PHT_SERVER. The handle can be obtained using the PrlSrv_Create function. The PHT_SERVER handle is required to use most of the functionality within the Parallels API.

PHT_SERVER_CONFIG

The PHT_SERVER_CONFIG handle is used to retrieve the host configuration information and some of the virtual machine configuration parameters as seen by the operating system running on a virtual machine. The handle is obtained from the PHT_JOB object returned by the PrlSrv_GetSrvConfig function call.

PHT_SERVER_INFO

The PHT_SERVER_INFO handle is a container that contains information about a host machine. The information includes the Parallels Service port number, host name, OS version, product version, and host machine UUID. To obtain this information for the specified Parallels Service, use the PrlSrv_GetServerInfo function. You can also search for Parallels Services running on your network by executing the PrlSrv_LookupParallelsServers function. The function returns a list of PHT_SERVER_INFO handles for the Parallels Services that it finds. The returned information can be used to establish a connection with the Parallels Service of interest.

PHT_SHARE

The PHT_SHARE handle is used to manage host shares. With this handle, you can make a host OS folder visible and accessible in a virtual machine. The handle is obtained by making the PrlVmCfg_GetShare or the PrlVmCfg_CreateShare function call.

PHT_STRINGS_LIST

The PHT_STRING_LIST handle is a generic string container. A new handle is created by making the PrlApi_CreateStringsList function call.

PHT_SYSTEM_STATISTICS

The PHT_SYSTEM_STATISTICS handle is used to obtain performance statistics for the host computer or an individual virtual machine.

PHT_SYSTEM_STATISTICS_CPU

The PHT_SYSTEM_STATISTICS_CPU handle is used to obtain CPU statistics. The handle is obtained by making the PrlStat_GetCpuStat function call.

PHT_SYSTEM_STATISTICS_DISK

The PHT_SYSTEM_STATISTICS_DISK object is used to obtain disk statistics. The handle is obtained by making the PrlStat_GetDiskStat function call.

PHT_SYSTEM_STATISTICS_DISK_PARTITION

The PHT_SYSTEM_STATISTICS_DISK_PARTITION handle is used to obtain disk partition statistics. The handle is obtained by making the PrlStatDisk_GetPartStat function call.

PHT_SYSTEM_STATISTICS_IFACE

The PHT_SYSTEM_STATISTICS_IFACE handle is used to obtain network interface statistics. The handle is obtained by making the PrlStat_GetIfaceStat function call.

PHT_SYSTEM_STATISTICS_PROCESS

The PHT_SYSTEM_STATISTICS_PROCESS handle is used to obtain system process statistics. The handle is obtained by making the PrlStat_GetProcStat function call.

PHT_SYSTEM_STATISTICS_USER_SESSION

The PHT_SYSTEM_STATISTICS_USER_SESSION handle is used to obtain user session statistics. The handle is obtained by making the PrlStat_GetUserStat function call.

PHT_USER_INFO

The PHT_USER_INFO handle is a container that contains information about an individual user. The handle is obtained by making the PrlSrv_GetUserInfo or the PrlSrv_GetUserInfoList function call. The handle can be obtained for any user (not just the currently logged in user). To obtain the information for the currently logged in user, see the PHT_USER_PROFILE handle.

PHT_USER_PROFILE

The PHT_USER_PROFILE handle is used to obtain information about the currently logged in user and for setting the user preferences. The handle is obtained by calling the PrlSrv_GetUserProfile function. To obtain information about any user (not just the currently logged on user), see the PHT_USER_INFO handle.

PHT_VIRTUAL_DEV_FLOPPY

The PHT_VIRTUAL_DEV_FLOPPY handle contains information about a virtual floppy disk in a virtual machine. The handle is obtained by making the PrlVmCfg_CreateVmDev or the PrlVmCfg_GetFloppyDisk function call.

PHT_VIRTUAL_DEV_HARD_DISK

The PHT_VIRTUAL_DEV_HARD_DISK handle is used to manage virtual hard disks in a virtual machine. The handle is obtained by making the PrlVmCfg_CreateVmDev or the PrlVmCfg_GetHardDisk function call.

PHT_VIRTUAL_DEV_HD_PARTITION

The PHT_VIRTUAL_DEV_HD_PARTITION handle is used to manage partitions of a virtual hard disk in a virtual machine. The handle is obtained by making the PrlVmDevHd_AddPartition or the PrlVmDevHd_GetPartition function call.

PHT_VIRTUAL_DEV_NET_ADAPTER

The PHT_VIRTUAL_DEV_NET_ADAPTER handle is used to manage network adapters in a virtual machine. The handle is obtained by making the PrlVmCfg_CreateVmDev or the PrlVmCfg_GetNetAdapter function call.

PHT_VIRTUAL_DEV_OPTICAL_DISK

The PHT_VIRTUAL_DEV_OPTICAL_DISK handle contains information about a virtual optical disks in a virtual machine. The handle is obtained by making the PrlVmCfg_CreateVmDev or the PrlVmCfg_GetOpticalDisk function call.

PHT_VIRTUAL_DEV_PARALLEL_PORT

The PHT_VIRTUAL_DEV_PARALLEL_PORT handle contains information about a virtual parallel port in a virtual machine. The handle is obtained by making the PrlVmCfg_CreateVmDev or the PrlVmCfg_GetParallelPort function call.

PHT_VIRTUAL_DEV_SERIAL_PORT

The PHT_VIRTUAL_DEV_SERIAL_PORT handle is used to manage serial ports in a virtual machine. The handle is obtained by making the PrlVmCfg_CreateVmDev or the PrlVmCfg_GetSerialPort function call.

PHT_VIRTUAL_DEV_SOUND

The PHT_VIRTUAL_DEV_SOUND handle is used to manage sound devices in a virtual machine.

PHT_VIRTUAL_DEV_USB_DEVICE

The PHT_VIRTUAL_DEV_USB handle is used to managing USB devices in a virtual machine.

PHT_VIRTUAL_DISK

The PHT_VIRTUAL_DISK handle is used to create, configure, and manage Parallels virtual disks. A virtual disk is comprised of a set of files. There's a configuration file containing information about the disk parameters (number of heads, cylinders, sectors, etc.) and there are files that are used for data storage. Once created, a virtual disk can be attached to a virtual machine and recognized by it, just like a physical hard disk can be installed in a physical box. To create a new virtual disk use PrlDisk_CreateDisk or PrlDisk_CreateDisk_Local . To obtain a handle to an existing virtual disk, use PrlDisk_OpenDisk ... more

PHT_VIRTUAL_MACHINE

PHT_VIRTUAL_MACHINE is the main virtual machine management handle. A handle to an existing virtual machine is obtained from the PHT_JOB object returned by the PrlSrv_GetVmList function. To create a new handle, call the PrlSrv_CreateVm function.

PHT_VIRTUAL_NETWORK

The PHT_VIRTUAL_NETWORK handle is used to manage virtual networks. A new handle is obtained by calling the PrlVirtNet_Create function. A handle to an existing virtual network is obtained by calling the PrlSrv_GetVirtualNetworkList function.

PHT_VM_CONFIGURATION

The PHT_VM_CONFIGURATION handle is used to manage the virtual machine configuration. The handle is obtained by calling the PrlVm_GetConfig function.

PHT_VM_GUEST_SESSION

The PHT_VM_GUEST_SESSION handle is used to run programs and execute administrative tasks in the virtual machine. The handle is obtained using the PrlVm_LoginInGuest function.

PHT_VM_INFO

The PHT_VM_INFO handle is a container that contains the virtual machine state, access rights, and other information. The handle is obtained by making the PrlVm_GetState function call.

PHT_VM_TOOLS_INFO

The PHT_VM_TOOLS_INFO handle is used to determine whether the Parallels Tools package is installed in the specified virtual machine and for obtaining its status and version information. The handle is obtained from the job object returned by the PrlVm_GetToolsState function.