Diagnoses the network connectivity of a VM in a Windows Network Virtualization Environment.
Syntax
uint32 DiagnoseNetworkConnection(
[in] Msvm_EthernetPortAllocationSettingData REF TargetNetworkAdapter,
[in] string DiagnosticSettings,
[out] string DiagnosticInformation,
[out] CIM_ConcreteJob REF Job
);
Parameters
TargetNetworkAdapter [in]
Reference to an Msvm_EthernetPortAllocationSettingData that describes the target network adapter.
DiagnosticSettings [in]
The diagnostic settings to use.
DiagnosticInformation [out]
On success, returns the diagnostic information.
Job [out]
If the operation is performed asynchronously, this method will return 4096, and this parameter will contain a reference to an object derived from CIM_ConcreteJob.
Return value
Returns a 0 or 4096 on success; otherwise, returns an error.
Completed with No Error (0)
Not Supported (1)
Failed (2)
Timeout (3)
Invalid Parameter (4)
DMTF Reserved (..)
Method Parameters Checked - Job Started (4096)
Method Reserved (4097..32767)
Vendor Specific (32768..65535)
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1703 [desktop apps only] |
| Minimum supported server | Windows Server 2016 |
| Namespace | Root\virtualization\v2 |
| MOF | WindowsVirtualization.V2.mof |
| DLL | Vmms.exe |
See also
Msvm_VirtualSystemManagementService
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
