IVMVirtualServer::DefaultVMConfigurationPath property

Article
2018-05-31

The DefaultVMConfigurationPath property contains the default directory searched by the web application to create lists of available virtual machine configuration files.

This property is read/write.

Syntax

HRESULT put_DefaultVMConfigurationPath(
  [in]  BSTR configurationPath
);

HRESULT get_DefaultVMConfigurationPath(
  [out] BSTR *configurationPath
);

VB
`VMVirtualServer.DefaultVMConfigurationPath( _ ByRef configurationPath, _ ByVal configurationPath _ )`

Property value

The default virtual machine configurations directory path. In the path string, a backslash () may appear immediately before the terminating null character.

This property value is read/write.

Error codes

Name	Meaning
S_OK	The operation was successful.
E_POINTER	The configurationPath parameter is NULL.
E_FILE_NOT_FOUND	The system cannot find the directory specified by the configurationPath parameter.
E_PATH_NOT_FOUND	The system cannot find the path specified by the configurationPath parameter.
E_INVALID_NAME	The configurationPath parameter contains an invalid character (one of the following: "*?<>/\|":").
E_BAD_PATHNAME	The configurationPath parameter specifies an empty or relative path. An absolute path is required.
E_BUFFER_OVERFLOW	The path specified by the configurationPath parameter is too long. The length of the path must be less than 260 characters.
DISP_E_EXCEPTION	An unexpected error occurred.

Remarks

By default, this property value is set to the following directory: "%ALLUSERSPROFILE%\Documents\Shared Virtual Machines\".

Examples

The following example displays the DefaultVMConfigurationPath property value of the VMVirtualServer object.

Set objVS = CreateObject("VirtualServer.Application")

Wscript.Echo "Name: " & objVS.Name
Wscript.Echo "Default VM configuration path: " & _
             objVS.DefaultVMConfigurationPath

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

Share via