Win32_NetworkProtocol クラス

Win32_NetworkProtocolWMI クラスは、Win32 コンピューター システム上のプロトコルとそのネットワーク特性を表します。

次の構文はマネージド オブジェクト フォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。 プロパティとメソッドは、MOF の順序ではなく、アルファベット順です。

構文

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D8-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkProtocol : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  boolean  ConnectionlessService;
  boolean  GuaranteesDelivery;
  boolean  GuaranteesSequencing;
  uint32   MaximumAddressSize;
  uint32   MaximumMessageSize;
  boolean  MessageOriented;
  uint32   MinimumAddressSize;
  string   Name;
  boolean  PseudoStreamOriented;
  boolean  SupportsBroadcasting;
  boolean  SupportsConnectData;
  boolean  SupportsDisconnectData;
  boolean  SupportsEncryption;
  boolean  SupportsExpeditedData;
  boolean  SupportsFragmentation;
  boolean  SupportsGracefulClosing;
  boolean  SupportsGuaranteedBandwidth;
  boolean  SupportsMulticasting;
  boolean  SupportsQualityofService;
};

メンバー

Win32_NetworkProtocol クラスには、次の種類のメンバーがあります。

• Properties

プロパティ

Win32_NetworkProtocol クラスには、これらのプロパティがあります。

Caption

データ型: string

アクセスの種類: 読み取り専用

修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短いテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

ConnectionlessService

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|dwServiceFlags|XP1_CONNECTIONLESS")

プロトコルでは、コネクションレス サービスがサポートされています。 コネクションレス (データグラム) サービスは、データ パケットが互いに独立してルーティングされ、異なるルートに従って送信された順序とは異なる順序で到着する可能性がある通信プロトコルまたはトランスポートを記述します。 逆に、接続指向サービスは、データ パケットが送信されたのと同じ順序で受信される仮想回線を提供します。 コンピューター間の接続に失敗すると、アプリケーションに通知されます。

説明

データ型: string

アクセスの種類: 読み取り専用

修飾子: DisplayName ("Description")

オブジェクトのテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

GuaranteesDelivery

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|dwServiceFlags|XP_GUARANTEED_DELIVERY")

プロトコルでは、データ パケットの配信がサポートされています。 このフラグが FALSE の場合、送信されるすべてのデータが目的の宛先に到達するかどうかは不明です。

GuaranteesSequencing

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|dwServiceFlags|XP_GUARANTEED_ORDER")

プロトコルは、データが送信された順序で到着することを保証します。 この特性では、データの配信は保証されず、その順序のみが保証されることに注意してください。

InstallDate

データ型: datetime

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされたタイミングを示します。 値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

MaximumAddressSize

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|iMaxSockAddr"), units ("characters")

プロトコルでサポートされるソケット アドレスの最大長。 ソケット アドレスには、URL () や IP アドレス130.215.24.1 (www.microsoft.com) などの項目を指定できます。

MaximumMessageSize

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|dwMessageSize"), units ("characters")

プロトコルでサポートされる最大メッセージ サイズ。 これは、ホストとの間で送受信できるメッセージの最大サイズです。 メッセージ フレーミングをサポートしていないプロトコルの場合、特定のアドレスに送信できるメッセージの実際の最大サイズがこの値より小さい場合があります。

MessageOriented

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|dwServiceFlags|XP_MESSAGE_ORIENTED")

プロトコルはメッセージ指向です。 メッセージ指向プロトコルでは、データのパケットを使用して情報を転送します。 逆に、ストリーム指向プロトコルは、データをバイトの連続ストリームとして転送します。

MinimumAddressSize

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|iMinSockAddr "), units ("characters")

プロトコルでサポートされるソケット アドレスの最小長。

名前

データ型: string

アクセスの種類: 読み取り専用

修飾子: key、 Override ("Name")、 MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|lpProtocol")

プロトコルの名前。

例: "TCP/IP"

PseudoStreamOriented

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32_API|Windows ソケット構造体|PROTOCOL_INFO|dwServiceFlags|XP_PSEUDO_STREAM")

プロトコルは、すべての受信操作に対して可変長データ パケットまたはストリーミング データを受信できるメッセージ指向プロトコルです。 この省略可能な機能は、アプリケーションがプロトコルでメッセージをフレーム化することを望まず、ストリーム指向の特性が必要な場合に便利です。 TRUE の場合、プロトコルは擬似ストリーム指向です。

状態

データ型: string

アクセスの種類: 読み取り専用

修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。 操作状態と非運用状態を定義できます。 運用状態には、"OK"、"機能低下"、"Pred Fail" を含めることができます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハード ディスク ドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、および "サービス" が含まれる場合があります。 "サービス" は、ディスクミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。 このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

注釈

Win32_NetworkProtocol クラスは、CIM_LogicalElementから派生します。

例

次の VBScript コード サンプルは、 Win32_NetworkProtocolのインスタンスから実行中のサービスの一覧を取得する方法を示しています。

Set ProtocolSet = GetObject("winmgmts:").ExecQuery("select * from Win32_NetworkProtocol")

for each Protocol in ProtocolSet
 WScript.Echo Protocol.Name
next

次の Perl コード サンプルは、 Win32_NetworkProtocolのインスタンスから実行中のサービスの一覧を取得する方法を示しています。

use strict;
use Win32::OLE;

my ( $ProtocolSet, $Protocol );

eval { $ProtocolSet = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
 ExecQuery("SELECT * FROM Win32_NetworkProtocol"); };
unless($@)
{
 print "\n";
 foreach $Protocol (in $ProtocolSet) 
 {
  print $Protocol->{Name}, "\n";
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

要件

こちらもご覧ください

CIM_LogicalElement

オペレーティング システム クラス