IVMVirtualServer::DefaultVMConfigurationPath property

  • Article

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

See also

IVMVirtualServer