UdpStatistics.IncomingDatagramsDiscarded Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the number of User Datagram Protocol (UDP) datagrams that were received and discarded because of port errors.
public:
abstract property long IncomingDatagramsDiscarded { long get(); };
public abstract long IncomingDatagramsDiscarded { get; }
member this.IncomingDatagramsDiscarded : int64
Public MustOverride ReadOnly Property IncomingDatagramsDiscarded As Long
Property Value
An Int64 value that specifies the total number of received UDP datagrams that were discarded because there was no listening application at the destination port.
Examples
The following code example displays the UDP statistics for the specified Internet Protocol version.
void ShowUdpStatistics( NetworkInterfaceComponent version )
{
IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
UdpStatistics ^ udpStat = nullptr;
switch ( version )
{
case NetworkInterfaceComponent::IPv4:
udpStat = properties->GetUdpIPv4Statistics();
Console::WriteLine( "UDP IPv4 Statistics" );
break;
case NetworkInterfaceComponent::IPv6:
udpStat = properties->GetUdpIPv6Statistics();
Console::WriteLine( "UDP IPv6 Statistics" );
break;
default:
throw gcnew ArgumentException( "version" );
break;
}
Console::WriteLine( " Datagrams Received ...................... : {0}", udpStat->DatagramsReceived );
Console::WriteLine( " Datagrams Sent .......................... : {0}", udpStat->DatagramsSent );
Console::WriteLine( " Incoming Datagrams Discarded ............ : {0}", udpStat->IncomingDatagramsDiscarded );
Console::WriteLine( " Incoming Datagrams With Errors .......... : {0}", udpStat->IncomingDatagramsWithErrors );
Console::WriteLine( " UDP Listeners ........................... : {0}", udpStat->UdpListeners );
Console::WriteLine( "" );
}
public static void ShowUdpStatistics(NetworkInterfaceComponent version)
{
IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
UdpStatistics udpStat = null;
switch (version)
{
case NetworkInterfaceComponent.IPv4:
udpStat = properties.GetUdpIPv4Statistics();
Console.WriteLine("UDP IPv4 Statistics");
break;
case NetworkInterfaceComponent.IPv6:
udpStat = properties.GetUdpIPv6Statistics();
Console.WriteLine("UDP IPv6 Statistics");
break;
default:
throw new ArgumentException("version");
// break;
}
Console.WriteLine(" Datagrams Received ...................... : {0}",
udpStat.DatagramsReceived);
Console.WriteLine(" Datagrams Sent .......................... : {0}",
udpStat.DatagramsSent);
Console.WriteLine(" Incoming Datagrams Discarded ............ : {0}",
udpStat.IncomingDatagramsDiscarded);
Console.WriteLine(" Incoming Datagrams With Errors .......... : {0}",
udpStat.IncomingDatagramsWithErrors);
Console.WriteLine(" UDP Listeners ........................... : {0}",
udpStat.UdpListeners);
Console.WriteLine("");
}
Remarks
To find the total number of datagrams that could not be delivered, add the values that were returned by this property and the IncomingDatagramsWithErrors property.