Share via


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
SmIscsiTarget.mof
DLL
SmIScsiTargetProv.dll

See also

MSISCSITARGET_StorageConfigurationService

CIM_ProtocolEndpoint

CIM_SettingData