# Network Metadata Provider

`INetworkInformationService` in assembly SanteDB.Core.Api version 3.0.1980.0

## Summary

Represents network information service

## Events

| Event                | Type         | Description                           |
| -------------------- | ------------ | ------------------------------------- |
| NetworkStatusChanged | EventHandler | Fired when the network status changes |

## Properties

| Property           | Type    | Access | Description                            |
| ------------------ | ------- | ------ | -------------------------------------- |
| IsNetworkAvailable | Boolean | R      | Gets whether the network is available  |
| IsNetworkConnected | Boolean | R      | Gets whether the network is connected. |
| IsNetworkWifi      | Boolean | R      | Returns true if the network is WIFI    |

## Operations

| Operation      | Response/Return                    | Input/Parameter       | Description              |
| -------------- | ---------------------------------- | --------------------- | ------------------------ |
| GetInterfaces  | IEnumerable\<NetworkInterfaceInfo> | *none*                | TODO                     |
| Ping           | Int64                              | *String* **hostName** | Pings the specified host |
| Nslookup       | String                             | *String* **address**  | Perform a DNS lookup     |
| GetHostName    | String                             | *none*                | TODO                     |
| GetMachineName | String                             | *none*                | TODO                     |

## Implementations

### Default Network Information Service - (SanteDB.Core.Api)

Default network information service

#### Service Registration

```markup
...
<section xsi:type="ApplicationServiceContextConfigurationSection" threadPoolSize="4">
	<serviceProviders>
		...
		<add type="SanteDB.Core.Services.Impl.DefaultNetworkInformationService, SanteDB.Core.Api, Version=3.0.1980.0, Culture=neutral, PublicKeyToken=null" />
		...
	</serviceProviders>
```

## Example Implementation

```csharp
/// Example Implementation
using SanteDB.Core.Services;
/// Other usings here
public class MyNetworkInformationService : SanteDB.Core.Services.INetworkInformationService { 
	public String ServiceName => "My own INetworkInformationService service";
	/// <summary>
	/// Fired when the network status changes
	/// </summary>
	public event EventHandler NetworkStatusChanged;
	/// <summary>
	/// Gets whether the network is available
	/// </summary>
	public Boolean IsNetworkAvailable {
		get;
	}
	/// <summary>
	/// Gets whether the network is connected.
	/// </summary>
	public Boolean IsNetworkConnected {
		get;
	}
	/// <summary>
	/// Returns true if the network is WIFI
	/// </summary>
	public Boolean IsNetworkWifi {
		get;
	}
	public IEnumerable<NetworkInterfaceInfo> GetInterfaces(){
		throw new System.NotImplementedException();
	}
	/// <summary>
	/// Pings the specified host
	/// </summary>
	public Int64 Ping(String hostName){
		throw new System.NotImplementedException();
	}
	/// <summary>
	/// Perform a DNS lookup
	/// </summary>
	public String Nslookup(String address){
		throw new System.NotImplementedException();
	}
	public String GetHostName(){
		throw new System.NotImplementedException();
	}
	public String GetMachineName(){
		throw new System.NotImplementedException();
	}
}
```

## References

* [INetworkInformationService C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Services_INetworkInformationService.htm)
* [DefaultNetworkInformationService C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Services_Impl_DefaultNetworkInformationService.htm)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.santesuite.org/developers/server-plugins/implementing-.net-features/service-definitions/network-metadata-provider.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.