Msvm_ProtocolControllerForUnit class

Article
01/07/2021

This association indicates that a subclass of logical device (for example a storage volume) is connected through a specific protocol controller. In many situations (for example storage LUN masking), there may be many of these associations used to relate to different objects. Therefore, subclasses have been defined to optimize enumeration of the associations.

The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.

Syntax

[Association, Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ProtocolControllerForUnit : CIM_ProtocolControllerForUnit
{
  CIM_ProtocolController REF Antecedent;
  CIM_LogicalDevice      REF Dependent;
  string                     DeviceNumber;
  uint16                     AccessPriority;
  uint16                     AccessState;
  uint16                     DeviceAccess;
};

Members

The Msvm_ProtocolControllerForUnit class has these types of members:

Properties

Properties

The Msvm_ProtocolControllerForUnit class has these properties.

AccessPriority

Data type: uint16
Access type: Read-only

The priority given to accesses of the device through this controller. The highest priority path will have the lowest value for this parameter. This class is inherited from CIM_ProtocolControllerForDevice.

AccessState

Data type: uint16
Access type: Read-only

Indicates whether the controller is actively commanding or accessing the device (2) or not (3). Also, the value, 0 (Unknown), can be defined. This information is necessary when a logical device can be commanded by, or accessed through, multiple protocol controllers. This class is inherited from CIM_ProtocolControllerForDevice.

Unknown (0)
Active (2)
Inactive (3 )

Antecedent

Data type: CIM_ProtocolController
Access type: Read-only

The protocol controller. This class is inherited from CIM_Dependency.

Dependent

Data type: CIM_LogicalDevice
Access type: Read-only

The controlled device. This class is inherited from CIM_Dependency.

DeviceAccess

Data type: uint16
Access type: Read-only

The access rights granted to the device through this controller. This class is inherited from CIM_ProtocolControllerForUnit.

Value	Meaning
0	Unknown
2	Read/Write
3	Read-only
4	No access.
5..15999	DMTF Reserved
16000..	Vendor reserved

DeviceNumber

Data type: string
Access type: Read-only

The address of the associated device in the context of the antecedent controller. This class is inherited from CIM_ProtocolControllerForDevice.

Remarks

Access to the Msvm_ProtocolControllerForUnit class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe