Win32_NetworkProtocol クラス

[アーティクル]
06/12/2023

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")

SupportsBroadcasting

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_SUPPORTS_BROADCAST")

プロトコルでは、ネットワーク経由でメッセージをブロードキャストするためのメカニズムがサポートされています。

SupportsConnectData

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_CONNECT_DATA")

プロトコルを使用すると、ネットワーク経由でデータを接続できます。

SupportsDisconnectData

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_DISCONNECT_DATA")

プロトコルを使用すると、ネットワーク経由でデータを切断できます。

SupportsEncryption

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_ENCRYPTS")

プロトコルでは、データ暗号化がサポートされています。

SupportsExpeditedData

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_EXPEDITED_DATA")

プロトコルは、ネットワーク全体で高速データ (緊急データとも呼ばれます) をサポートします。優先データは、フロー制御をバイパスし、通常のデータパケットよりも優先順位を受け取ることができます。

SupportsFragmentation

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_FRAGMENTATION")

プロトコルでは、フラグメント内のデータの送信がサポートされています。物理ネットワークの最大転送単位 (MTU) は、アプリケーションに対して非表示になっています。各メディアタイプには、超過できない最大フレームサイズがあります。リンク層は MTU を検出し、使用されているプロトコルに報告します。

SupportsGracefulClosing

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_GRACEFUL_CLOSE")

プロトコルでは、"グレースフルクローズ操作" とも呼ばれる 2 フェーズのクローズ操作がサポートされています。そうでない場合、プロトコルは中止終了操作のみをサポートします。

SupportsGuaranteedBandwidth

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_BANDWIDTH_ALLOCATION")

プロトコルには、帯域幅を確立して維持するためのメカニズムがあります。

SupportsMulticasting

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|PROTOCOL_INFO|dwServiceFlags|XP_SUPPORTS_MULTICAST")

プロトコルはマルチキャストをサポートします。

SupportsQualityofService

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32_API|Windows ソケットの構造|WSAPROTOCOL_INFO|dwServiceFlags1|XP1_QOS_SUPPORTED")

プロトコルは、基になるレイヤードサービスプロバイダーまたはトランスポートキャリアによるサービス品質 (QoS) サポートが可能です。 QoS は、ネットワーク経由で送信されるデータのサブセットの差別化と優先処理を可能にするコンポーネントのコレクションです。 QoS は、ネットワークを通過するときに、データのサブセットの優先順位が高くなるか、サービスが保証されていることを意味します。

注釈

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";
}

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

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

Win32_NetworkProtocol クラス

構文

メンバー

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース