Home Reference WMI Reference root CIMV2 Win32_NetworkProtocol
 

Win32_NetworkProtocol

The Win32_NetworkProtocol class represents a protocol and its network characteristics on a Win32 computer system.

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

Caption

Data type String

The Caption property is a short textual description (one-line string) of the object.

ConnectionlessService

Data type Boolean

The ConnectionlessService property indicates whether the protocol supports connectionless service. A connectionless (datagram) service describes a communications protocol or transport in which data packets are routed independently of each other and may follow different routes and arrive in a different order from that in which they were sent. Conversely, a connection-oriented service provides a virtual circuit through which data packets are received in the same order they were transmitted. If the connection between machines fails, the application is notified.

Values: $true or $false. A value of $true indicates the protocol uses aconnectionless service.

Description

Data type String

The Description property provides a textual description of the object.

GuaranteesDelivery

Data type Boolean

The GuaranteesDelivery property indicates whether the protocol guarantees that all data sent will reach the intended destination. If this flag is $false, there is no such guarantee.

Values: $true or $false. A value of $true indicates the protocol supports guaranteed delivery of data packets.

GuaranteesSequencing

Data type Boolean

The GuaranteesSequencing property indicates whether the protocol guarantees that data will arrive in the order in which it was sent. Note that this characteristic does not guarantee delivery of the data, only its order.

Values: $true or $false. A value of $true indicates the order of data sent is guaranteed.

InstallDate

Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

MaximumAddressSize

Data type UInt32

The MaximumAddressSize property indicates the maximum length of a socket address supported by the protocol. Socket addresses may be items like URLs (www.microsoft.com) or IP addresses (130.215.24.1).

MaximumMessageSize

Data type UInt32

The MaximumMessageSize property indicates the maximum message size supported by the protocol. This is the maximum size of a message that can be sent from or received by the host. For protocols that do not support message framing, the actual maximum size of a message that can be sent to a given address may be less than this value. There are two special values defined for this property:

0
 The protocol is stream-oriented; the concept of message size is not relevant.

1
 The maximum outbound (send) message size is dependent on the underlying network MTU (maximum sized transmission unit) and hence cannot be known until after a socket is bound. Applications should use getsockopt to retrieve the value of SO_MAX_MSG_SIZE after the socket has been bound to a local address.

0xFFFFFFFF – There is no specified maximum message size defined.

MessageOriented

Data type Boolean

The MessageOriented property indicates whether the protocol is message-oriented. A message-oriented protocol uses packets of data to transfer information. Conversely, stream-oriented protocols transfer data as a continuous stream of bytes.

Values: $true or $false. A value of $true indicates the protocol is message oriented.

MinimumAddressSize

Data type UInt32

The MinimumAddressSize property specifies the minimum length of a socket address supported by the protocol.

Name

Data type String

The Name property contains the name for the protocol.

Example: TCP/IP

Option

Data type UInt32

PseudoStreamOriented

Data type Boolean

The PseudoStreamOriented property indicates whether the protocol is a message-oriented protocol that can receive variable-length data packets or streamed data for all receive operations. This optional capability is useful when an application does not want the protocol to frame messages, and requires stream-oriented characteristics.

Values: $true or $false. A value of $true indicates the protocol is pseudo stream-oriented.

SecurityDescriptor

Data type Object

Status

Data type String

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “Error”, “Starting”, “Stopping” and “Service”. The latter, “Service”, could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither “OK” nor in one of the other states.

'OK','Error','Degraded','Unknown','Pred Fail','Starting','Stopping','Service','Stressed','NonRecover','No Contact','Lost Comm'

SupportsBroadcasting

Data type Boolean

The SupportsBroadcasting property indicates whether the protocol supports a mechanism for broadcasting messages across the network.

Values: $true or $false. A value of $true indicates the protocol supports broadcasting.

SupportsConnectData

Data type Boolean

The SupportsConnectData property indicates whether the protocol allows data to be connected across the network.

Values: $true or $false. A value of $true indicates the protocol allows data to be connected.

SupportsDisconnectData

Data type Boolean

The SupportsDisconnectData property indicates whether the protocol allows data to be disconnected across the network.

Values: $true or $false. A value of $true indicates the protocol allows data to be disconnected.

SupportsEncryption

Data type Boolean

The SupportsEncryption property indicates whether the protocol supports data encryption.

Values: $true or $false. A value of $true indicates the protocol supports data encryption.

SupportsExpeditedData

Data type Boolean

The SupportsExpeditedData property indicates whether the protocol supports expedited data (also known as urgent data) across the network. Expedited data can bypass flow control and receive priority over normal data packets.

Values: $true or $false. A value of $true indicates the protocol supports expedited data.

SupportsFragmentation

Data type Boolean

The SupportsFragmentation property indicates whether the protocol supports transmitting the data in fragments. Physical network Maximum Transfer Unit (MTU) is hidden from applications. Each media type has a maximum frame size that cannot be exceeded. The link layer is responsible for discovering the MTU and reporting it to the protocols being used.

Values: $true or $false. A value of $true indicates the protocol supports transmitting the data in fragments.

SupportsGracefulClosing

Data type Boolean

The SupportsGracefulClosing property indicates whether the protocol supports two-phase close operations – also known as graceful close operations. If not, the protocol supports only abortive close operations.

Values: $true or $false. A value of $true indicates the protocol supports graceful closing of network connections.

SupportsGuaranteedBandwidth

Data type Boolean

The SupportsGuaranteedBandwidth property indicates whether the protocol has a mechanism to establish and maintain a guaranteed bandwidth.

Values: $true or $false. A value of $true indicates the protocol supports a guaranteed bandwidth.

SupportsMulticasting

Data type Boolean

The SupportsMulticasting property indicates whether the protocol supports multicasting.

Values: $true or $false. A value of $true indicates the protocol supports multicasting.

SupportsQualityofService

Data type Boolean

The SupportsQualityofService property indicates whether the protocol is capable of Quality of Service (QOS) support via the underlying layered service provider or transport carrier. QOS is a collection of components that enable differentiation and preferential treatment for subsets of data transmitted over the network. QOS loosely means subsets of data get higher priority or guaranteed service when traversing a network.

Values:$true or $false. A value of $true indicates the protocol supports QOS.

Methods

Examples

See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:22:16 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin