CreateReplicationBuffer method of the CIM_StorageConfigurationService class

Create (or start a job to create) a replication buffer that buffers asynchronous write operations for remote mirror pairs. The buffer is an instance of CIM_Memory with an AssociatedMemory association to a hosting system or to a replication network pipe. The buffer element may be created based on a StorageExtent, in a pool or in a manner opaque to a client. If 0 is returned, the function completed successfully and no ConcreteJob instance is created. If 0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter. A return value of 1 indicates the method is not supported. All other values indicate some type of error condition.

If Job Completed with No Error (0) is returned, the function completed successfully and a ConcreteJob instance is not created.

If Method Parameters Checked - Job Started (0x1000) is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.

A return value of Not Supported (1) indicates the method is not supported.

All other values indicate some type of error condition.

Syntax

uint32 CreateReplicationBuffer(
  [out] CIM_ConcreteJob    REF Job,
  [in]  CIM_ManagedElement REF Host,
  [in]  CIM_StorageExtent  REF TargetElement,
  [in]  CIM_StoragePool    REF TargetPool,
  [out] CIM_Memory         REF ReplicaBuffer
);

Parameters

Job [out]

Reference to the job (may be null if the task completed).

Host [in]

The hosting system or replication pipe that will be antecedent to the created buffer.

TargetElement [in]

Reference to a component extent for the buffer element.

TargetPool [in]

Reference to a container pool for the buffer element.

ReplicaBuffer [out]

Reference to the created replica buffer element.

Return value

Job Completed with No Error (0)

Not Supported (1)

Unspecified Error (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

In Use (6)

DMTF Reserved (7 4095)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097 32767)

Vendor Specific (32768 65535)

Requirements

See also

CIM_StorageConfigurationService