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類別具有下列類型的成員：

屬性

屬性

Win32_NetworkProtocol類別具有這些屬性。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

ConnectionlessService

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP1_CONNECTIONLESS「)

通訊協定支援無聯機服務。無連線 (資料包) 服務描述通訊協定或傳輸，其中資料封包會彼此獨立路由傳送，而且可能會遵循不同的路由並依不同的順序抵達它們。相反地，連線導向服務會提供虛擬線路，以傳輸資料封包的相同順序接收。如果電腦之間的連線失敗，則會通知應用程式。

說明

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Description」)

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

GuaranteesDelivery

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_GUARANTEED_DELIVERY「)

通訊協定支援傳遞資料封包。如果此旗標為 FALSE，不確定所有傳送的資料都會到達預定的目的地。

GuaranteesSequencing

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_GUARANTEED_ORDER「)

通訊協定可確保資料會依傳送的順序抵達。請注意，這項特性無法確保資料傳遞，只有其順序。

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

指出何時安裝物件。缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

MaximumAddressSize

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|iMaxSockAddr「) ，單位 (」characters「)

通訊協定支援的通訊端位址長度上限。通訊端位址可能是 URL (www.microsoft.com) 或 IP 位址 130.215.24.1 () 等專案。

MaximumMessageSize

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwMessageSize「) ，單位 (」characters「)

通訊協定支援的訊息大小上限。這是主機可以傳送或接收的訊息大小上限。對於不支援訊息框架的通訊協定，可以傳送至指定位址之訊息的實際大小上限可能小於此值。

MessageOriented

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_MESSAGE_ORIENTED「)

通訊協定是訊息導向的。訊息導向通訊協定會使用資料封包來傳輸資訊。相反地，資料流程導向通訊協定會將資料傳輸為位元組的連續資料流程。

MinimumAddressSize

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|iMinSockAddr 「) ， units (」characters「)

通訊協定支援的通訊端位址長度下限。

名稱

資料類型：字串
存取類型：唯讀
限定詞： 索引鍵、覆寫 (「Name」) 、 MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|lpProtocol「)

通訊協定的名稱。

範例：「TCP/IP」

PseudoStreamOriented

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_PSEUDO_STREAM「)

通訊協定是訊息導向的通訊協定，可接收所有接收作業的可變長度資料封包或資料流程處理的資料。當應用程式不想讓通訊協定框架訊息，而且需要資料流程導向特性時，這個選擇性功能就很有用。如果 為 TRUE，則通訊協定為虛擬資料流程導向。

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10) 、 DisplayName (「Status」)

字串，表示物件的目前狀態。可以定義作業和非作業狀態。作業狀態可以包含「確定」、「已降級」和「預先失敗」。「預先失敗」表示元素正常運作，但預測失敗 (例如啟用 SMART 的硬碟) 。

非作業狀態可以包含「錯誤」、「正在啟動」、「停止」和「服務」。「服務」可以在磁片鏡像重新儲存、重載使用者權限清單或其他系統管理工作期間套用。並非所有這類工作都在線上，但 Managed 元素既不是「OK」，也不是處於其他狀態之一。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

OK (「OK」)

錯誤 (「錯誤」)

降級 (「已降級」)

未知 (「未知」)

預先失敗 (「預先失敗」)

開始 (「開始」)

停止 (「停止」)

服務 (「服務」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

沒有連絡人 (「沒有連絡人」)

Lost Comm (「Lost Comm」)

SupportsBroadcasting

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_SUPPORTS_BROADCAST「)

通訊協定支援透過網路廣播訊息的機制。

SupportsConnectData

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_CONNECT_DATA「)

通訊協定允許透過網路連線資料。

SupportsDisconnectData

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_DISCONNECT_DATA「)

通訊協定可讓資料透過網路中斷連線。

SupportsEncryption

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_ENCRYPTS「)

通訊協定支援資料加密。

SupportsExpeditedData

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_EXPEDITED_DATA「)

通訊協定支援加速資料 (也稱為跨網路) 緊急資料。加速資料可以略過流量控制，並接收一般資料封包的優先順序。

SupportsFragmentation

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_FRAGMENTATION「)

通訊協定支援以片段傳輸資料。實體網路最大傳輸單位 (MTU) 會隱藏在應用程式中。每個媒體類型都有無法超過的最大畫面大小。連結層會探索 MTU，並將它回報給所使用的通訊協定。

SupportsGracefulClosing

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_GRACEFUL_CLOSE「)

通訊協定支援兩階段關閉作業，也稱為「正常關閉作業」。如果沒有，通訊協定只支援中止的關閉作業。

SupportsGuaranteedBandwidth

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_BANDWIDTH_ALLOCATION「)

通訊協定具有建立和維護頻寬的機制。

SupportsMulticasting

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |PROTOCOL_INFO|dwServiceFlags|XP_SUPPORTS_MULTICAST「)

通訊協定支援多播。

SupportsQualityofService

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32_API|Windows Sockets 結構 |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 類別

語法

成員

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源