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

Minimum supported client	None supported
Minimum supported server	Windows Server 2016
Namespace	Root\Microsoft\Windows\Storage\SM
MOF	MsftStrgMan.mof
DLL	StorageService.dll

See also

MSFT_SMSystem