IVMVirtualMachine::Security property

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