IVMDisplay::SetDimensions method

發行項
05/31/2018

The SetDimensions method sets the height and width, in pixels, of the virtual machine's display.

Syntax

HRESULT SetDimensions(
  [in] long displayPixelWidth,
  [in] long displayPixelHeight
);

Parameters

displayPixelWidth [in]: The width, in pixels, of the virtual machine's display. The argument must be between the values of 640 and 1600 and be evenly divisible by 8.
displayPixelHeight [in]: The height, in pixels, of the virtual machine's display. The argument must be between the values of 480 and 1200 and be evenly divisible by 8.

Return value

This method can return one of these values.

This method supports standard return values, as well as the following. For information on Virtual Server specific return values not listed below, see HRESULT Codes Specific to the Virtual Server.

Return code	Description
S_OK	The operation was successful.
E_INVALIDARG	The parameter is not evenly divisible by 8 or is outside of the allowed minimum (640x480) or maximum (1600x1200) values.
VM_E_VM_UNKNOWN	The virtual machine is not valid or is not currently running.
VM_E_NO_DISPLAY	Unable to locate a valid display for the virtual machine.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL	The version of the additions installed in the guest operating system does not support this operation.
DISP_E_EXCEPTION	An unexpected error occurred.

Remarks

The minimum size of the virtual machine's display is 640 x 480 pixels. The maximum size is 1600 x 1200. Attempts to set the display size to values outside these limits, or to any value not evenly divisible by 8, will result in an E_INVALIDARG error being returned.

Requirements


Product	Microsoft Virtual Server 2005 onWindows Server 2003
Download	Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header	VsComInterfaces.h

共用方式為