WindowsXP/admin/wmi/wbem/providers/ping/mof/ping_01.mof

// **************************************************************************

// Copyright (c) 1999-2001 Microsoft Corporation, All Rights Reserved
//
// File:  HIProv.mof
//
// Description:
//			MOF file for the ping instance provider.
//			Contains instances required to register this provider with
//			WBEM, and the definition of the class that this provider provides.
//
// History:
//
// **************************************************************************

/////////////////////////////////////////////////////////////////////
// Declare an instance of the __Win32Provider so as to "register" the
// HTTP provider
/////////////////////////////////////////////////////////////////////
#pragma Namespace("\\root\\cimv2")

instance of __Win32Provider as $WMIPingProvider
{
    Name    = "WMIPingProvider" ;
    ClsId   = "{734AC5AE-68E1-4fb5-B8DA-1D92F7FC6661}" ;
} ;    

instance of __InstanceProviderRegistration
{
    Provider = $WMIPingProvider;
    SupportsPut = FALSE;
    SupportsGet = TRUE;
    SupportsDelete = FALSE;
    SupportsEnumeration = TRUE;
    QuerySupportLevels = { "WQL:UnarySelect" } ;
};

/////////////////////////////////////////////////////////////////////
// Declare a class whose dynamic instances are provided by the 
// sample provider.
/////////////////////////////////////////////////////////////////////
	[dynamic, provider("WMIPingProvider"), Description ("The "
	"Win32_PingProtocolStatus class contains the values returned by the "
	"standard ping command. More information on ping can be found in RFC 791.")]
class Win32_PingProtocolStatus
{
		[Key,Description("The Address property holds the value of the address "
		"requested.  This can be either hostname ('wxyz1234') or IP address "
		"('193.128.177.124').")
		]
	String Address = "" ;

		[Key,Description("The TimeToLive property indicates the lifespan of "
		"the ping packet in seconds. This is an upper limit and not absolute "
		"as all routers MUST decrement this value by one and hops between "
		"routers rarely take this amount of time.  When this value becomes "
		"zero the packet will be dropped by the router. The default value "
		"is 80 seconds.")
		]
	uint32 TimeToLive = 80 ;

		[Key,Description("The Timeout property indicates the Timeout value in "
		"milliseconds. If a response is not received in this time no response "
		" will be assumed. The default is 4000 milliseconds.")
		]
	uint32 Timeout = 4000 ;

		[Key,Description("The BufferSize property indicates the buffer size sent "
		"with the ping command.  The default value is 32.")
		]
	uint32 BufferSize = 32 ;

		[Key,Description("The NoFragmentation property sets a 'Don't Fragment' on "
		"packets sent.  The default is False, not fragmented.")
		]
	boolean NoFragmentation = FALSE ;

		[Key,Description("the TypeOfService property indicates which type of service "
		"is used.  The default value is 0."), ValueMap { "0", "2", "4", "8", "16"},
		Values{"Normal", "Minimize Monetary Cost", "Maximize Reliability",
			"Maximize Throughput", "Mimimize Delay"}
		]
	uint32 TypeofService = 0 ;

		[Key,Description("The RecordRoute property indicates how many hops "
		"should be recorded while the packet is enroute. The default is zero.")
		]
	uint32 RecordRoute = 0 ;

		[Key,Description("The TimestampRoute property indicates how many hops "
		"should be recorded with time stamp information while the packet is enroute. "
		"A Timestamp is the number of milliseconds that have passed since midnight "
		"UT. If the time is not available in milliseconds or cannot be provided with "
		"respect to midnight UT then any time may be inserted as a timestamp provided "
		"the high order bit of the timestamp field is set to one to indicate the use "
		"of a non-standard value. The default is zero.")
		]
	uint32 TimestampRoute = 0 ;

		[Key,Description("The SourceRouteType property indicates the type of source "
		"route option to be used on host list specified in the SourceRoute property. "
		"If a value outside of the ValueMap is specified 0 is assumed. The default "
		" is zero."), ValueMap{"0", "1", "2"}, Values{"None", "Loose Source Routing",
			"Strict Source Routing"}
		]
	uint32 SourceRouteType = 0 ;

		[Key,Description("The SourceRoute property contais a comma separated list "
		"of valid Source Routes.")
		]
	String SourceRoute = "" ;

		[Key, Description("The ResolveAddressesNames indicates whether or not the "
		"command will resolve address names of output address values.  The default "
		"is False - no resolution.")
		]
	boolean ResolveAddressNames = FALSE ;
	
		[read, Description("The StatusCode property returns the ping status codes."),
		ValueMap { "0", "11001", "11002", "11003", "11004", "11005", "11006",
		"11007", "11008", "11009", "11010", "11011", "11012", "11013", "11014",
		"11015", "11016", "11017", "11018", "11032", "11050"},
		Values {"IP Success", "IP Buffer Too Small", "IP Destination Net Unreachable",
			"IP Destination Host Unreachable", "IP Destination Protocol Unreachable",
			"IP Destination Port Unreachable", "IP No Resources", "IP Bad Option",
			"IP Hardware Error", "IP Packet Too Big", "IP Request Timed Out",
			"IP Bad Request", "IP Bad Route", "IP TimeToLive Expired Transit",
			"IP TimeToLive Expired Reassembly", "IP Parameter Problem",
			"IP Source Quench","IP Option Too Big", "IP Bad Destination",
			"IP Negotiating IPSEC", "IP General Failure"
			}
		]
	uint32 StatusCode ;

		[read, Description("The ResponseTime property indicates the time elapsed "
		"to handle the request.")
		]
	uint32 ResponseTime ;

		[read, Description ("The ResponseTimeToLive property indicates the time "
		"to live from moment the request is received.")
		]
	uint32 ResponseTimeToLive ;

		[read, Description("The ReplyInconsistency property reports inconsistent "
		"reply data.")
		]
	boolean ReplyInconsistency ;

		[read, Description("The ReplySize property indicates the size of the "
		"buffer returned.")
		]
	uint32 ReplySize ;

		[read, Description("The RouteRecord property holds a record of intermediate hops.")
		]	
	String RouteRecord [] ;

		[read, Description("The RouteRecordResolved property holds the resolved "
		"address corresponding to the RouteRecord entry.")
		]	
	String RouteRecordResolved [] ;

		[read, Description("The TimeStampRecord property holds a record timestamps for "
		"intermediate hops.")
		]	
	uint32 TimeStampRecord [] ;

		[read, Description("The TimeStampRecordAddress property holds the intermediate hop "
		"corresponding to the TimeStampRecord entry.")
		]	
	string TimeStampRecordAddress [] ;

		[read, Description("The TimeStampRecordAddressResolved property holds the resolved "
		"address corresponding to the TimeStampRecordAddress entry.")
		]	
	string TimeStampRecordAddressResolved [] ;

		[MaxLen(4096), Description("The ProtocolAddress property contains the address "
		"that the destination used to reply.")
		]	
	String ProtocolAddress="";
		[MaxLen(4096), Description("The ProtocolAddressResolved property contains the "
		"resolved address corresponding to the ProtocolAddress property")
		]	
	String ProtocolAddressResolved="";

};