次の方法で共有

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 メソッドは、ネットワークのすべてのネットワーク接続の列挙を返します。 1 つのネットワークに対して、異なるインターフェイスからの複数の接続、または同じインターフェイスからの異なるリンクを持つことができます。
INetwork::GetNetworkId

GetNetworkId メソッドは、ネットワークの一意識別子を返します。
INetwork::GetTimeCreatedAndConnected

GetTimeCreatedAndConnected メソッドは、ネットワークが作成され、接続されたローカル日時を返します。
INetwork::SetCategory

SetCategory メソッドは、ネットワークのカテゴリを設定します。 加えられた変更はすぐに有効になります。 この API の呼び出し元は、Administrators グループのメンバーである必要があります。
INetwork::SetDescription

SetDescription メソッドは、ネットワークの説明を設定または置き換えます。
INetwork::SetName

SetName メソッドは、ネットワークを設定または名前変更します。

注釈

INetwork を実装する COM オブジェクトは、追加のプロパティのプロパティ バッグも実装します。 このプロパティ バッグにアクセスするには、 INetwork インターフェイスと QueryInterface for IPropertyBag を使用できます。 この COM オブジェクトのプロパティ バッグには、次のプロパティが含まれています。

パラメーター Type 説明
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 トラフィックがキャプティブ ポータルにリダイレクトされている場合、このフラグが設定されます。

  • NLM_INTERNET_CONNECTIVITY_PROXIED (0x2)

    検出されたネットワークにプロキシ構成があります。 たとえば、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 インターフェイスは、IPropertyBag::Read メソッドと IPropertyBag::Write メソッドの一部として LPCOLESTRを受け入れます。 便宜上、これらのプロパティの文字列値は、同じ名前を使用して netlistmgr.h 内で定義されます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー netlistmgr.h