INetwork-Schnittstelle (netlistmgr.h)

Die INetwork-Schnittstelle stellt ein Netzwerk auf dem lokalen Computer dar. Es kann auch eine Sammlung von Netzwerkverbindungen mit einer ähnlichen Netzwerksignatur darstellen.

Vererbung

Die INetwork-Schnittstelle erbt von der IUnknown-Schnittstelle . INetwork verfügt auch über folgende Arten von Membern:

Methoden

Die INetwork-Schnittstelle verfügt über diese Methoden.

INetwork::get_IsConnected Die eigenschaft get_IsConnected gibt an, ob das Netzwerk über netzwerkkonnektivität verfügt.
INetwork::get_IsConnectedToInternet Die eigenschaft get_IsConnectedToInternet gibt an, ob das Netzwerk über eine Internetverbindung verfügt.
INetwork::GetCategory Die GetCategory-Methode gibt die Kategorie eines Netzwerks zurück.
INetwork::GetConnectivity Die GetConnectivity-Methode gibt den Konnektivitätsstatus des Netzwerks zurück.
INetwork::GetDescription Die GetDescription-Methode gibt eine Beschreibungszeichenfolge für das Netzwerk zurück.
INetwork::GetDomainType Die GetDomainType-Methode gibt den Domänentyp eines Netzwerks zurück.
INetwork::GetName Die GetName-Methode gibt den Namen eines Netzwerks zurück.
INetwork::GetNetworkConnections Die GetNetworkConnections-Methode gibt eine Enumeration aller Netzwerkverbindungen für ein Netzwerk zurück. Ein Netzwerk kann über mehrere Verbindungen über verschiedene Schnittstellen oder unterschiedliche Verbindungen von derselben Schnittstelle verfügen.
INetwork::GetNetworkId Die GetNetworkId-Methode gibt den eindeutigen Bezeichner eines Netzwerks zurück.
INetwork::GetTimeCreatedAndConnected Die GetTimeCreatedAndConnected-Methode gibt das lokale Datum und die Uhrzeit zurück, zu der das Netzwerk erstellt und verbunden wurde.
INetwork::SetCategory Die SetCategory-Methode legt die Kategorie eines Netzwerks fest. Vorgenommene Änderungen werden sofort wirksam. Aufrufer dieser API müssen Mitglieder der Gruppe Administratoren sein.
INetwork::SetDescription Die SetDescription-Methode legt die Beschreibung für ein Netzwerk fest oder ersetzt sie.
INetwork::SetName Die SetName-Methode legt ein Netzwerk fest oder benennt es um.

Hinweise

Das COM-Objekt, das INetwork implementiert, implementiert auch einen Eigenschaftenbehälter für zusätzliche Eigenschaften. Um Zugriff auf diesen Eigenschaftenbehälter zu erhalten, können Sie die INetwork-Schnittstelle und QueryInterface für IPropertyBag verwenden. Der Eigenschaftenbehälter für dieses COM-Objekt enthält die folgenden Eigenschaften:

Parameter	Typ	BESCHREIBUNG
NA_DomainAuthenticationFailed	VT_BOOL	Gibt an, dass ein Domänennetzwerk nicht in der Lage ist, sich beim Domänencontroller zu authentifizieren.
NA_NetworkClass	NLM_NETWORK_CLASS als VT_UINT gespeicherter Wert	Gibt die Netzwerkklasse an. Mögliche Werte sind: NLM_NETWORK_IDENTIFYING (0x01) Dies ist das spezielle "Identifizierende" Netzwerk. Es können keine Eigenschaften dieser Netzwerkklasse geändert werden. NLM_NETWORK_IDENTIFIED (0x02) Dies ist ein identifiziertes Netzwerk. NLM_NETWORK_UNIDENTIFIED (0x03) Dies ist das spezielle "Unidentified"-Netzwerk. Die Kategorie dieses Netzwerks kann geändert werden, aber sie wird nicht beibehalten, wenn das Netzwerk getrennt wird.
NA_InternetConnectivityV4 oder NA_InternetConnectivityV6	NLM_INTERNET_CONNECTIVITY Als VT_UINT gespeicherter Wert	Enthält Details zur IPv4- oder IPv6-Netzwerkkonnektivität. Mögliche Werte sind: NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1) Das erkannte Netzwerk ist ein Hotspot. Wenn beispielsweise eine Verbindung mit einem Kaffee-Wi-Fi Hotspot-Netzwerk hergestellt wird und der lokale HTTP-Datenverkehr an ein Captive-Portal umgeleitet wird, wird dieses Flag festgelegt. NLM_INTERNET_CONNECTIVITY_PROXIED (0x2) Das erkannte Netzwerk verfügt über eine Proxykonfiguration. Wenn beispielsweise eine Verbindung mit einem Unternehmensnetzwerk über einen Proxy für den HTTP-Zugriff hergestellt wird, wird dieses Flag festgelegt. NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4) Der Computer wurde für den direkten Zugriff konfiguriert, und der Zugriff auf das Unternehmensdomänennetzwerk wird erkannt, für das Direct Access konfiguriert wurde.
NA_NameSetByPolicy	VT_BOOL	Der Name des Netzwerks wurde durch die Gruppenrichtlinie festgelegt.
NA_IconSetByPolicy	VT_BOOL	Das Symbol des Netzwerks wurde durch die Gruppenrichtlinie festgelegt.
NA_DescriptionSetByPolicy	VT_BOOL	Die Beschreibung des Netzwerks wurde durch die Gruppenrichtlinie festgelegt.
NA_CategorySetByPolicy	VT_BOOL	Die Kategorie des Netzwerks wurde durch die Gruppenrichtlinie festgelegt.
NA_NameReadOnly	VT_BOOL	Der Name des Netzwerks ist schreibgeschützter Name.
NA_IconReadOnly	VT_BOOL	Das Symbol des Netzwerks ist schreibgeschützter Wert.
NA_DescriptionReadOnly	VT_BOOL	Die Beschreibung des Netzwerks ist schreibgeschützter Wert.
NA_CategoryReadOnly	VT_BOOL	Die Kategorie des Netzwerks ist schreibgeschützt.
NA_AllowMerge	VT_BOOL	Das Netzwerk kann mit einem anderen Netzwerk zusammengeführt werden.

 

Die IPropertyBag-Schnittstelle akzeptiert LPCOLESTR als Teil der Methoden IPropertyBag::Read und IPropertyBag::Write . Der Einfachheit halber werden die Zeichenfolgenwerte für diese Eigenschaften in netlistmgr.h mit den gleichen Namen definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netlistmgr.h