CreateOrModifyReplicationPipe method of the MSISCSITARGET_StorageConfigurationService class
Establishes a peer-to-peer connection that is represented by a CIM_NetworkPipe element and two CIM_ProtocolEndpoint elements. A return value of Busy (0x1000) indicates that the method is not supported.
This method is inherited from the CIM_StorageConfigurationService class.
Syntax
uint32 CreateOrModifyReplicationPipe(
[in] string PipeElementName,
[in] CIM_ComputerSystem Ref SourceSystem,
[in] CIM_ComputerSystem Ref TargetSystem,
[in] CIM_ProtocolEndpoint Ref SourceEndpoint[],
[in] CIM_ProtocolEndpoint Ref TargetEndpoint[],
[in] string Goal,
[in, out] CIM_NetworkPipe Ref ReplicationPipe
);
Parameters
-
PipeElementName [in]
-
Specifies a user-friendly name for the element to be created.
-
SourceSystem [in]
-
Specifies one of the two peer systems that participate in the peer-to-peer connection. If the provider supports uni-directional connections, this property must identify the system that hosts the source elements.
-
TargetSystem [in]
-
Specifies one of the two peer systems that participate in the peer-to-peer connection. If the provider supports uni-directional connections, this property must identify the system that hosts the target elements.
-
SourceEndpoint [in]
-
Specifies the source system endpoints to be assigned to the pipe. Must be NULL, if a provider does not enable the client to manage port assignments. If an existing pipe is modified, this set of endpoints replaces the previous set. If this parameter is not NULL, it must contain the same number of endpoints as the TargetEndpoint parameter so that the two parameters specify a set of endpoint pairs.
-
TargetEndpoint [in]
-
Specifies the target system endpoints to be assigned to the pipe. Must be NULL, if a provider does not enable the client to manage port assignments. If an existing pipe is modified, this set of endpoints replaces the previous set. If this parameter is not NULL, it must contain the same number of endpoints as the SourceEndpoint parameter so that the two parameters specify a set of endpoint pairs.
-
Goal [in]
-
Specifies the characteristics, qualities of service, and goals for the peer-to-peer connection, in the form of a string representation of a CIM_SettingData instance.
-
ReplicationPipe [in, out]
-
On input, optionally specifies an existing network pipe to modify. The specified protocol endpoints replaces any existing endpoints in the specified pipe. If NULL, a new network pipe is created with the specified protocol endpoints.
On return, contains a reference to the created or modified network pipe.
Return value
This method returns one of the following values.
-
Job Completed with No Error (0)
-
Not Supported (1)
-
Unspecified Error (2)
-
Timeout (3)
-
Failed (4)
-
Invalid Parameter (5)
-
DMTF Reserved (6 0x0FFF)
-
Busy (0x1000)
-
Method Reserved (0x1001 0x7FFF)
-
Vendor Specific (0x8000 0xFFFF)
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 R2 |
| Namespace |
Root\CIMv2\Storage\iScsiTarget |
| MOF |
|
| DLL |
|