IVMVirtualMachine::Security property

  • Article

The IVMSecurity object associated with this virtual machine.

This property is read-only.

Syntax

HRESULT get_Security(
  [out] IVMSecurity **outSecurity
);

VB 
VMVirtualMachine.Security( _
  ByRef outSecurity _
)

Property value

An VMSecurity instance that represents the security attributes of this virtual machine.

This property value is read-only.

Error codes

Name Meaning
S_OK
 The operation was successful.
E_POINTER
 The outSecurity parameter is NULL.
E_OUTOFMEMORY
 Could not allocate memory for the security descriptor.
VM_E_VM_UNKNOWN
 The configuration is unknown.
DISP_E_EXCEPTION
 An unexpected error has occurred.

Examples

The following example displays VMSecurity properties of a VMVirtualMachine object.

Set objVS = CreateObject("VirtualServer.Application")
Set objVM = objVS.FindVirtualMachine("Windows Server 2003")
Set objSec = objVM.Security

WScript.Echo "VM Name: " & objVM.Name
WScript.Echo "Security principle: "
WScript.Echo "    Owner Name: " & objSec.OwnerName
WScript.Echo "    Owner SID: " & objSec.OwnerSID
WScript.Echo "    Group Name: " & objSec.GroupName
WScript.Echo "    Group SID: " & objSec.GroupSID

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

IVMVirtualMachine