INetwork 介面 (netlistmgr.h)

  • 發行項

INetwork 介面代表本機電腦上的網路。 它也可以代表具有類似網路簽章的網路連線集合。

繼承

INetwork 介面繼承自 IUnknown 介面。 INetwork 也有下列類型的成員：

方法

INetwork 介面具有這些方法。

 
INetwork：：get_IsConnected

get_IsConnected 屬性會指定網路是否有任何網路連線。
INetwork：：get_IsConnectedToInternet

get_IsConnectedToInternet屬性會指定網路是否有因特網連線。
INetwork：：GetCategory

GetCategory 方法會傳回網路的類別。
INetwork：：GetConnectivity

GetConnectivity 方法會傳回網路的連線狀態。
INetwork：：GetDescription

GetDescription 方法會傳回網路的描述字串。
INetwork：：GetDomainType

GetDomainType 方法會傳回網路的網域類型。
INetwork：：GetName

GetName 方法會傳回網路的名稱。
INetwork：：GetNetworkConnections

GetNetworkConnections 方法會傳回網路的所有網路連線列舉。 網路可以從不同的介面或來自相同介面的不同連結，對它進行多個連線。
INetwork：：GetNetworkId

GetNetworkId 方法會傳回網路的唯一標識符。
INetwork：：GetTimeCreatedAndConnected

GetTimeCreatedAndConnected 方法會傳回建立和連線網路時的本機日期和時間。
INetwork：：SetCategory

SetCategory 方法會設定網路的類別。 所做的變更會立即生效。 此 API 的呼叫端必須是 Administrators 群組的成員。
INetwork：：SetDescription

SetDescription 方法會設定或取代網路的描述。
INetwork：：SetName

SetName 方法會設定或重新命名網路。

備註

實作 INetwork 的 COM 物件也會針對其他屬性實作屬性包。 若要存取此屬性包，您可以使用 INetwork 介面和適用於 IPropertyBag 的 QueryInterface。 此 COM 物件上的屬性套含下列屬性：

參數 類型 Description
NA_DomainAuthenticationFailed VT_BOOL 指定網域網路無法對域控制器進行驗證。
NA_NetworkClass 儲存 為VT_UINT的NLM_NETWORK_CLASS值 指定網路的類別。 可能的值包括：
  • NLM_NETWORK_IDENTIFYING (0x01)

    這是特殊的「識別」網路。 此網路類別上沒有屬性可以變更。

  • NLM_NETWORK_IDENTIFIED (0x02)

    這是已識別的網路。

  • NLM_NETWORK_UNIDENTIFIED (0x03)

    這是特殊的「未識別」網路。 此網路的類別可以變更，但在網路中斷連線時不會保存。
NA_InternetConnectivityV4

或

NA_InternetConnectivityV6

 儲存為 VT_UINT 的NLM_INTERNET_CONNECTIVITY值 提供有關 IPv4 或 IPv6 網路連線的詳細數據。 可能的值包括：
  • NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1)

    偵測到的網路是熱點。 例如，連線到咖啡機 Wi-Fi 熱點網路，而本機 HTTP 流量會重新導向至 Captive 入口網站時，將會設定此旗標。

  • NLM_INTERNET_CONNECTIVITY_PROXIED (0x2)

    偵測到的網路具有 Proxy 組態。 例如，使用 Proxy 連線到公司網路進行 HTTP 存取時，將會設定此旗標。

  • NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4)

    計算機已設定為直接存取，並偵測到已針對公司網域網路直接存取進行存取。
NA_NameSetByPolicy VT_BOOL 組策略已設定網路名稱。
NA_IconSetByPolicy VT_BOOL 網路圖示已由組策略設定。
NA_DescriptionSetByPolicy VT_BOOL 網路的描述已由組策略設定。
NA_CategorySetByPolicy VT_BOOL 網路類別已由組策略設定。
NA_NameReadOnly VT_BOOL 網路的名稱是唯讀的。
NA_IconReadOnly VT_BOOL 網路的圖示是唯讀的。
NA_DescriptionReadOnly VT_BOOL 網路的描述是唯讀的。
NA_CategoryReadOnly VT_BOOL 網路的類別是唯讀的。
NA_AllowMerge VT_BOOL 網路可以與另一個網路合併。
 

IPropertyBag 介面接受 LPCOLESTR 做為 IPropertyBag：：Read 和 IPropertyBag：：Write 方法的一部分。 為了方便起見，這些屬性的字串值會在 netlistmgr.h 內使用相同的名稱定義。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 netlistmgr.h