Interfaccia INetwork (netlistmgr.h)

L'interfaccia INetwork rappresenta una rete nel computer locale. Può anche rappresentare una raccolta di connessioni di rete con una firma di rete simile.

Ereditarietà

L'interfaccia INetwork eredita dall'interfaccia IUnknown . INetwork include anche questi tipi di membri:

Metodi

L'interfaccia INetwork include questi metodi.

INetwork::get_IsConnected La proprietà get_IsConnected specifica se la rete ha una connettività di rete.
INetwork::get_IsConnectedToInternet La proprietà get_IsConnectedToInternet specifica se la rete ha connettività Internet.
INetwork::GetCategory Il metodo GetCategory restituisce la categoria di una rete.
INetwork::GetConnectivity Il metodo GetConnectivity restituisce lo stato di connettività della rete.
INetwork::GetDescription Il metodo GetDescription restituisce una stringa di descrizione per la rete.
INetwork::GetDomainType Il metodo GetDomainType restituisce il tipo di dominio di una rete.
INetwork::GetName Il metodo GetName restituisce il nome di una rete.
INetwork::GetNetworkConnections Il metodo GetNetworkConnections restituisce un'enumerazione di tutte le connessioni di rete per una rete. Una rete può avere più connessioni da interfacce diverse o collegamenti diversi dalla stessa interfaccia.
INetwork::GetNetworkId Il metodo GetNetworkId restituisce l'identificatore univoco di una rete.
INetwork::GetTimeCreatedAndConnected Il metodo GetTimeCreatedAndConnected restituisce la data e l'ora locale in cui è stata creata e connessa la rete.
INetwork::SetCategory Il metodo SetCategory imposta la categoria di una rete. Le modifiche apportate hanno effetto immediatamente. I chiamanti di questa API devono essere membri del gruppo Administrators.
INetwork::SetDescription Il metodo SetDescription imposta o sostituisce la descrizione per una rete.
INetwork::SetName Il metodo SetName imposta o rinomina una rete.

Commenti

L'oggetto COM che implementa INetwork implementa anche un contenitore di proprietà per proprietà aggiuntive. Per accedere a questo contenitore di proprietà, è possibile usare l'interfaccia INetwork e QueryInterface per IPropertyBag. Il contenitore delle proprietà in questo oggetto COM contiene le proprietà seguenti:

Parametro	Tipo	Descrizione
NA_DomainAuthenticationFailed	VT_BOOL	Specifica che una rete di dominio non è in grado di eseguire l'autenticazione con il controller di dominio.
NA_NetworkClass	NLM_NETWORK_CLASS valore archiviato come VT_UINT	Specifica la classe di rete. I valori possibili sono: NLM_NETWORK_IDENTIFYING (0x01) Si tratta della rete speciale "Identificazione". Nessuna proprietà in questa classe di rete può essere modificata. NLM_NETWORK_IDENTIFIED (0x02) Si tratta di una rete identificata. NLM_NETWORK_UNIDENTIFIED (0x03) Si tratta della rete speciale "Unidentified". La categoria di questa rete può essere modificata, ma non verrà mantenuta quando la rete viene disconnessa.
NA_InternetConnectivityV4 oppure NA_InternetConnectivityV6	NLM_INTERNET_CONNECTIVITY valore archiviato come VT_UINT	Fornisce informazioni dettagliate sulla connettività di rete IPv4 o IPv6. I valori possibili sono: NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1) La rete rilevata è un hotspot. Ad esempio, quando si è connessi a un caffè Wi-Fi rete hotspot e il traffico HTTP locale viene reindirizzato a un portale captive, questo flag verrà impostato. NLM_INTERNET_CONNECTIVITY_PROXIED (0x2) La rete rilevata ha una configurazione proxy. Ad esempio, quando si è connessi a una rete aziendale usando un proxy per l'accesso HTTP, questo flag verrà impostato. NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4) Il computer è stato configurato per l'accesso diretto e l'accesso viene rilevato nella rete di dominio aziendale Per l'accesso diretto è stato configurato.
NA_NameSetByPolicy	VT_BOOL	Il nome della rete è stato impostato dai criteri di gruppo.
NA_IconSetByPolicy	VT_BOOL	L'icona della rete è stata impostata dai criteri di gruppo.
NA_DescriptionSetByPolicy	VT_BOOL	La descrizione della rete è stata impostata dai criteri di gruppo.
NA_CategorySetByPolicy	VT_BOOL	La categoria della rete è stata impostata dai criteri di gruppo.
NA_NameReadOnly	VT_BOOL	Il nome della rete è di sola lettura.
NA_IconReadOnly	VT_BOOL	L'icona della rete è di sola lettura.
NA_DescriptionReadOnly	VT_BOOL	La descrizione della rete è di sola lettura.
NA_CategoryReadOnly	VT_BOOL	La categoria della rete è di sola lettura.
NA_AllowMerge	VT_BOOL	La rete può essere unita a un'altra rete.

 

L'interfaccia IPropertyBag accetta LPCOLESTR come parte dei metodi IPropertyBag::Read e IPropertyBag::Write . Per praticità, i valori stringa per queste proprietà vengono definiti all'interno di netlistmgr.h usando gli stessi nomi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	netlistmgr.h