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
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 |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
