CreateReplicationGroup method of the MSFT_SMSystem class

Creates a replication group on a storage subsystem.

Syntax

UInt32 CreateReplicationGroup(
  [in]            String                     FriendlyName,
  [in]            MSFT_SMStorageObject   REF StorageElements[],
  [in]            MSFT_SMReplicationSettings ReplicationSettings,
  [out]           MSFT_SMReplicationGroup    CreatedReplicationGroup,
  [out]           MSFT_SMJob             REF Job,
  [out, optional] MSFT_SMExtendedStatus      ExtendedStatus,
  [in, optional]  String                     username,
  [in, optional]  String                     password
);

Parameters

FriendlyName [in]

The user friendly name of the replication group.

StorageElements [in]

An array that contains the storage objects to replicate. The order of these array elements determines the consistency order of the replicas.

ReplicationSettings [in]

A MSFT_SMReplicationSettings object that specifies the settings to apply to the source replication group.

CreatedReplicationGroup [out]

When this method returns, this parameter contains the MSFT_SMReplicationGroup object that represents the new replication group.

Job [out]

A MSFT_SMJob object that specifies a reference to a job if this method returns "Method Parameters Checked - Job Started". If this operation performs synchronously, this parameter is set to NULL.

ExtendedStatus [out, optional]

A MSFT_SMExtendedStatus object that specifies detailed status information about the result of this operation.

username [in, optional]

The username to use to authenticate the SMI-S provider. If this parameter is not set, the storage service will attempt to retrieve the credentials from the configuration provider.

password [in, optional]

The password to use to authenticate the SMI-S provider. If this parameter is not set, the storage service will attempt to retrieve the credentials from the configuration provider.

Return value

The possible return values are:

Success (0)

Not Supported (1)

Unspecified Error (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

Object Not Found (8)

Method Parameters Checked - Job Started (4096)

Access denied (40001)

There are not enough resources to complete the operation. (40002)

Cache out of date (40003)

Requirements

See also

MSFT_SMSystem