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:
|
|
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:
|
| 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 |