AttachDevice method of the MSISCSITARGET_ControllerConfigurationService class

Associates a CIM_LogicalDevice subclass, such as CIM_StorageVolume to the referenced CIM_ProtocolController. The association is persisted as an instance of the CIM_ProtocolControllerForUnit class.

This method is inherited from the CIM_ControllerConfigurationService class.

Syntax

uint32 AttachDevice(
  [in]      CIM_ProtocolController Ref ProtocolController,
  [in]      CIM_LogicalDevice Ref      Device,
  [in, out] string                     DeviceNumber
);

Parameters

ProtocolController [in]

Specifies the antecedent protocol controller instance.

Device [in]

Specifies the logical device instance to attach.

DeviceNumber [in, out]

Specifies the number assigned to the CIM_ProtocolControllerForUnit.DeviceNumber property if client assigned numbers are supported by the hardware. Hardware support is indicated by the CIM_ProtocolControllerMaskingCapabilities.ClientSelectableDeviceNumbers property.

[!Important]
The management instrumentation provider must verify that the logical unit numbers specified using the DeviceNumber parameter are unique for the protocol controller.

Return value

This method returns one of the following values.

Success (0)

Not Supported (1)

Unspecified Error (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

DMTF Reserved (6 4095)

Invalid LogicalDevice Instance (4096)

Device Number Conflict (4097)

DeviceNumber Parameter Must Be Provided (4098)

Hardware Implementation Requires Null DeviceNumber (4099)

Busy (4100)

Method Reserved (4101 32767)

Vendor Specific (32768 65535)

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012 R2
Namespace
Root\CIMv2\Storage\iScsiTarget
MOF
SmIscsiTarget.mof
DLL
SmIScsiTargetProv.dll

See also

MSISCSITARGET_ControllerConfigurationService

MSISCSITARGET_ProtocolControllerForUnit

MSISCSITARGET_ProtocolControllerMaskingCapabilities

MSISCSITARGET_AuthorizedTarget