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
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 R2 |
| Namespace |
Root\CIMv2\Storage\iScsiTarget |
| MOF |
|
| DLL |
|