Share via


TestNetworkConnection method of the Msvm_VirtualSystemManagementService class

Tests the network connectivity of a virtual machine in a Windows Network Virtualization environment.

Syntax

uint32 TestNetworkConnection(
  [in]  Msvm_EthernetPortAllocationSettingData REF TargetNetworkAdapter,
  [in]  boolean                                    IsSender,
  [in]  string                                     SenderIP,
  [in]  string                                     ReceiverIP,
  [in]  string                                     ReceiverMac,
  [in]  uint32                                     IsolationId,
  [in]  uint32                                     SequenceNumber,
  [out] uint32                                     RoundTripTime,
  [out] CIM_ConcreteJob                        REF Job
);

Parameters

TargetNetworkAdapter [in]

A reference to the Msvm_EthernetPortAllocationSettingData that represents the network adapter of the virtual machine.

IsSender [in]

true if to invoke the method at the sender; otherwise, false.

SenderIP [in]

The IP address of the sender.

ReceiverIP [in]

The IP address of the receiver.

ReceiverMac [in]

The MAC address of the receiver.

IsolationId [in]

The isolation ID.

SequenceNumber [in]

The sequence number.

RoundTripTime [out]

The round trip time of the network.

Job [out]

A reference to an optional job for the operation if the operation is run asynchronously.

Return value

The possible return values are:

Completed with No Error (0)

Not Supported (1)

Failed (2)

Timeout (3)

Invalid Parameter (4)

DMTF Reserved (5 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 2016
Namespace
Root\HyperVCluster\v2
MOF
WindowsHyperVCluster.V2.mof
DLL
VMMS.exe

See also

Msvm_VirtualSystemManagementService