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値 | ネットワークのクラスを指定します。 次の値を指定できます。
|
NA_InternetConnectivityV4 または NA_InternetConnectivityV6 |
VT_UINT として格納されているNLM_INTERNET_CONNECTIVITY値 |
IPv4 または IPv6 ネットワーク接続に関する詳細を提供します。 次の値を指定できます。
|
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 |