Edit

Share via

IVMMouse::VerticalPosition property

  • Article

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Retrieves the absolute y-coordinate of the mouse.

This property is read/write.

Syntax

HRESULT put_VerticalPosition(
  [in]          long position
);

HRESULT get_VerticalPosition(
  [out, retval] long *position
);

Property value

The y-coordinate indicating the new position of the mouse. When using absolute coordinates, this value specifies the new y-coordinate of the mouse. When using relative coordinates, this value specifies the number of pixels the mouse should be moved in the y direction.

Error codes

Name/value Meaning
S_OK
0
 The operation was successful.
E_POINTER
0x80004003
 The parameter is NULL.
VM_E_VM_NOT_RUNNING
0xA0040206
 The virtual machine to which this mouse device is attached is not currently running.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Integration components must be installed to retrieve the mouse position, or to set the mouse position when using absolute coordinates.
VM_E_USING_RELATIVE_COORDINATES
0xA0040802
 The mouse device is currently set to use relative mouse coordinates.
VM_E_MOUSE_NOT_ACTIVE
0xA0040800
 The absolute coordinates cannot be retrieved if the mouse device is not powered up, or if it is not currently active in the virtual machine.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.

Remarks

This property cannot be retrieved when using relative coordinates.

Requirements

Requirement Value
Minimum supported client
 Windows 7 [desktop apps only]
Minimum supported server
 None supported
End of client support
 Windows 7
Product
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMmouse is defined as ac903f6d-6346-4f29-8875-5d511a13895e

See also

IVMMouse