CreateReplica method of the MSISCSITARGET_StorageConfigurationService class

Creates a new storage object which is a replica of the specified source storage object.

This method is inherited from the CIM_StorageConfigurationService class.

Syntax

uint32 CreateReplica(
  [in]  string                 ElementName,
  [out] CIM_ConcreteJob Ref    Job,
  [in]  CIM_LogicalElement Ref SourceElement,
  [out] CIM_LogicalElement Ref TargetElement,
  [in]  CIM_StorageSetting Ref TargetSettingGoal,
  [in]  CIM_StoragePool Ref    TargetPool,
  [in]  uint16                 CopyType
);

Parameters

ElementName [in]

A end user relevant name for the element being created. The value will be propagated to the ElementName property of the created element. If NULL, a system supplied default name is used.

Job [out]

On return contains a reference to the job, if a job is created and not completed.

SourceElement [in]

Specifies the source storage object which may be a MSISCSITARGET_StorageVolume or storage object.

TargetElement [out]

On return, refers to the created replica storage element.

TargetSettingGoal [in]

Specifies the MSISCSITARGET_StorageSetting used to configure the replica storage object.

TargetPool [in]

Specifies the underlying storage from which the replica storage object is allocated. If NULL, the allocation is implementation specific.

CopyType [in]

Specifies the type of copy to make.

Async (2)

Create and maintain an asynchronous copy of the source.

Sync (3)

Create and maintain a synchronized copy of the source.

UnSyncAssoc (4)

Create an unsynchronized copy and maintain an association to the source.

UnSyncUnAssoc (5)

Create an unsynchronized and disassociated copy of the source element.

DMTF Reserved

Reserved.

Vendor Specific

Reserved.

Return value

This method returns one of the following values.

Job Completed with No Error (0)

Not Supported (1)

Unknown (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

In Use (6)

DMTF Reserved (7 4095)

Method Parameters Checked - Job Started (4096)

Size Not Supported (4097)

Method Reserved (4098 32767)

Vendor Specific (32768 65535)

Requirements

See also

MSISCSITARGET_StorageConfigurationService