Leica.Disto.Networking

Helper class for device type (3DD, LD5+) handling

Get the upon the given WLAN SSID

The WLAN SSID

Get the WLAN SSID prefix of the given device type

Get the upon the given type code. The type code is returned by the 'who' broadcast request.

Check whether the 3D Disto with the given serial number is a Leica branded 3D Disto.

Check whether the 3D Disto with the given serial number is a Geomax branded 3D Disto.

Check if the given ssid is a disto device

Check wheter the 3D Disto is of the first version group: Ad-Hoc WLAN and no DHCP server.

Check wheter the 3D Disto is of the second version group: Infrastructure (hot spot) WLAN and DHCP server.

Class representing a SkyCom device

Constructor

The type of device The serial number of the device

Check whether this is a pseudo device for disconnecting

Overridden ToString

Type of SkyCom device (3DD or LD5+)

The serial number of the device

The equipment number of the device

The wlan network of the device as recognized by the wlan interface

The IP address in the wlan network

Check whether this device has a dhcp server on the wlan network

The IP address in the ndis (USB) network

The connected network or the network to be connected

Flag indicating whether the device is connected or not;

Device brand (manufacturer or reseller)

Leica

LaserTech

GeoMax

Device Type

Unknown device for this API

3D Disto (Leica), ? (GeoMax)

S910 (Leica brand), TruPoint (LaserTech brand)

The different kinds of accessing the network which sensor and control-unit are connected to.

No network access

access via WLAN

access via USB/RNDIS

Helper class for getting the channel out of the sensor's wlan ssid

Extracts the wlan channel number from the ssid which is in the format 3DD_00123456_Chn010

Get the serial number of a sensor out of his WLAN SSID

Description of a connected Device

Constructor for IpDeviceDescriptor. Sets all attributes.

Ip Adress of the device

Serial Number of the device

Software Name of the device

Software Version of the device

WLAN-Software Version of the device

Class for network configuration on Windows platforms (XP, Vista, Win7, Win8)

Contructor

Check that the host RNDIS IP is a valid IPv4 address and that it matches the subnet of the sensor’s RNDIS IP address. If it does not match, the IP address is adjusted accordingly. Changing the IP address requires admin rights. Without the required permissions, an will be thrown.

Sensor’s IP address of the RNDIS adapter

Enables the hosts WLAN interface.

Name of the wlan adapter to be used The WLAN's ESSID. The sensor's WLAN IP Address True when enabling the WLAN succeeded and the sensor could be pinged, false otherwise.

Enables the hosts WLAN interface.

Name of the wlan adapter to be used The WLAN's ESSID. The sensor's WLAN IP Address Use any existing wlan profile for this Ssid True when enabling the WLAN succeeded and the sensor could be pinged, false otherwise.

Enables the hosts WLAN interface.

Name of the wlan adapter to be used The WLAN's ESSID. The sensor's WLAN IP Address The Key to the Wlan True when enabling the WLAN succeeded and the sensor could be pinged, false otherwise.

Enable the hosts WLAN wlanInterface.

Name of the wlan adapter to be used The WLAN's ESSID. The Key to the Wlan Use any existing wlan profile for this Ssid True when enabling the WLAN succeeded, false otherwise.

Disable the hosts WLAN interface and restores the previous configuration.

True when successful, false otherwise.

Returns a list of WLAN interfaces available on the machine.

Check if the Wlan Adapter is already connected to the selected Network (SSID)

Wlan Adapter Name of the SSID to compare with

Returns a List of DISTO WLAN Networks available on the machine

Connect to a Disto Wlan-Network. If no key is set in the parameter, the usage of existing Wlan profiles is tried.

the wlan to connect connect using an existing wlan profile (if available)

Returns a list of WLAN networks available on the given interface. A scan takes at most 4 seconds.

WLAN interface, or null for a default interface

Returns a list of Devices which can be accessed A scan cam take a few seconds

Connect to a WLAN Network with the given interface.

Wlan network key (if needed) If a wlan profile for this Ssid is available, this will be used

Creates Wlan Profile.

Should most likely be true. If IP is not enabled, the adapter cannot be configured.

Contains information about a WLAN network.

Constructor.

Network name (SSID)

Secured (means need Key)

Network Key

Link quality in [0,100]

Contains information about a WLAN network and the adapter where its available

Constructor.

Contains information about a WLAN network.

Contains information about a WLAN interface.

Contains information about the device

Constructor

The network interface for taking over the current configuration

Check if a given ip address is in the same subnet as this configuration

Set the tcp configuration

The network interface to be set The desired ip addresses The desired subnet masks

Calculate the next ip address, e.g. for trying a connection

Defines the Native Wifi API through P/Invoke interop.

This class is intended for internal use. Use the class instead. Not supported on Windows XP SP2: must be a null reference. Not supported on Windows XP SP2: must be a null reference. Not supported on Windows XP SP2: must be a null reference.

Helper method to wrap calls to Native WiFi API methods. If the method falls, throws an exception containing the error code.

The error code. Thrown if the error code indicates anything but success.

Defines various opcodes used to set and query parameters for an interface.

Corresponds to the native WLAN_INTF_OPCODE type.

Opcode used to set or query whether auto config is enabled.

Opcode used to set or query whether background scan is enabled.

Opcode used to set or query the media streaming mode of the driver.

Opcode used to set or query the radio state.

Opcode used to set or query the BSS type of the interface.

Opcode used to query the state of the interface.

Opcode used to query information about the current connection of the interface.

Opcose used to query the current channel on which the wireless interface is operating.

Opcode used to query the supported auth/cipher pairs for infrastructure mode.

Opcode used to query the supported auth/cipher pairs for ad hoc mode.

Opcode used to query the list of supported country or region strings.

Opcode used to set or query the current operation mode of the wireless interface.

Opcode used to query driver statistics.

Opcode used to query the received signal strength.

Specifies the origin of automatic configuration (auto config) settings.

Corresponds to the native WLAN_OPCODE_VALUE_TYPE type.

The auto config settings were queried, but the origin of the settings was not determined.

The auto config settings were set by group policy.

The auto config settings were set by the user.

The auto config settings are invalid.

Defines flags passed to .

Include all ad-hoc network profiles in the available network list, including profiles that are not visible.

Include all hidden network profiles in the available network list, including profiles that are not visible.

The header of an array of information about available networks.

Contains the number of items following the header.

The index of the current item. The index of the first item is 0.

Defines the flags which specify characteristics of an available network.

This network is currently connected.

There is a profile for this network.

Contains information about an available wireless network.

Contains the profile name associated with the network. If the network doesn't have a profile, this member will be empty. If multiple profiles are associated with the network, there will be multiple entries with the same SSID in the visible network list. Profile names are case-sensitive.

Contains the SSID of the visible wireless network.

Specifies whether the network is an infrastructure or an ad-hoc one.

Indicates the number of BSSIDs in the network.

Indicates whether the network is connectable.

Indicates why a network cannot be connected to. This member is only valid when is false.

The number of PHY types supported on available networks. The maximum value of this field is 8. If more than 8 PHY types are supported, must be set to true.

Contains an array of values that represent the PHY types supported by the available networks. When is greater than 8, this array contains only the first 8 PHY types.

Specifies if there are more than 8 PHY types supported. When this member is set to true, an application must call to get the complete list of PHY types. contains the PHY type for an entry.

A percentage value that represents the signal quality of the network. This field contains a value between 0 and 100. A value of 0 implies an actual RSSI signal strength of -100 dbm. A value of 100 implies an actual RSSI signal strength of -50 dbm. You can calculate the RSSI signal strength value for values between 1 and 99 using linear interpolation.

Indicates whether security is enabled on the network.

Indicates the default authentication algorithm used to join this network for the first time.

Indicates the default cipher algorithm to be used when joining this network.

Contains various flags specifying characteristics of the available network.

Reserved for future use. Must be set to NULL.

Gets the values that represent the PHY types supported by the available networks.

The only option available on Windows XP SP2.

Defines the access mask of an all-user profile.

The user can view profile permissions.

The user has read access, and the user can also connect to and disconnect from a network using the profile.

The user has execute access and the user can also modify and delete permissions associated with a profile.

Defines the mask which specifies where a notification comes from.

All notifications, including those generated by the 802.1X module.

Notifications generated by the auto configuration module.

Notifications generated by MSM.

Notifications generated by the security module.

Notifications generated by independent hardware vendors (IHV).

Defines the types of ACM () notifications.

The enumeration identifiers correspond to the native wlan_notification_acm_ identifiers. On Windows XP SP2, only the ConnectionComplete and Disconnected notifications are available.

Defines the types of an MSM () notifications.

The enumeration identifiers correspond to the native wlan_notification_msm_ identifiers.

Contains information provided when registering for WLAN notifications.

Corresponds to the native WLAN_NOTIFICATION_DATA type.

Specifies where the notification comes from.

On Windows XP SP2, this field must be set to , or .

Indicates the type of notification. The value of this field indicates what type of associated data will be present in .

Indicates which interface the notification is for.

Specifies the size of , in bytes.

Pointer to additional data needed for the notification, as indicated by .

Gets the notification code (in the correct enumeration type) according to the notification source.

Defines the callback function which accepts WLAN notifications.

Defines flags which affect connecting to a WLAN network.

Connect to the destination network even if the destination is a hidden network. A hidden network does not broadcast its SSID. Do not use this flag if the destination network is an ad-hoc network. If the profile specified by is not null, then this flag is ignored and the nonBroadcast profile element determines whether to connect to a hidden network.

Do not form an ad-hoc network. Only join an ad-hoc network if the network already exists. Do not use this flag if the destination network is an infrastructure network.

Ignore the privacy bit when connecting to the network. Ignoring the privacy bit has the effect of ignoring whether packets are encryption and ignoring the method of encryption used. Only use this flag when connecting to an infrastructure network using a temporary profile.

Exempt EAPOL traffic from encryption and decryption. This flag is used when an application must send EAPOL traffic over an infrastructure network that uses Open authentication and WEP encryption. This flag must not be used to connect to networks that require 802.1X authentication. This flag is only valid when is set to . Avoid using this flag whenever possible.

Specifies the parameters used when using the function.

Corresponds to the native WLAN_CONNECTION_PARAMETERS type.

Specifies the mode of connection.

Specifies the profile being used for the connection. The contents of the field depend on the : Value of Contents of the profile string The name of the profile used for the connection. The XML representation of the profile used for the connection. , or null

Pointer to a structure that specifies the SSID of the network to connect to. This field is optional. When set to null, all SSIDs in the profile will be tried. This field must not be null if is set to or .

Pointer to a Dot11BssidList structure that contains the list of basic service set (BSS) identifiers desired for the connection.

On Windows XP SP2, must be set to null.

A value that indicates the BSS type of the network. If a profile is provided, this BSS type must be the same as the one in the profile.

Specifies ocnnection parameters.

On Windows XP SP2, must be set to 0.

The connection state of an ad hoc network.

The ad hoc network has been formed, but no client or host is connected to the network.

A client or host is connected to the ad hoc network.

Contains information about a basic service set (BSS).

Contains the SSID of the access point (AP) associated with the BSS.

The identifier of the PHY on which the AP is operating.

Contains the BSS identifier.

Specifies whether the network is infrastructure or ad hoc.

The received signal strength in dBm.

The link quality reported by the driver. Ranges from 0-100.

If 802.11d is not implemented, the network interface card (NIC) must set this field to TRUE. If 802.11d is implemented (but not necessarily enabled), the NIC must set this field to TRUE if the BSS operation complies with the configured regulatory domain.

Contains the beacon interval value from the beacon packet or probe response.

The timestamp from the beacon packet or probe response.

The host timestamp value when the beacon or probe response is received.

The capability value from the beacon packet or probe response.

The frequency of the center channel, in kHz.

Contains the set of data transfer rates supported by the BSS.

The offset of the information element (IE) data blob.

The size of the IE data blob, in bytes.

Contains the set of supported data rates.

The length, in bytes, of .

An array of supported data transfer rates.

Calculates the data transfer rate in mbit/s for a supported rate.

The WLAN rate index (0-based). The data transfer rate in mbit/s. Thrown if does not specify an existing rate.

Gets an array of supported data transfer rates. If the rate is a basic rate, the first bit of the rate value is set to 1. A basic rate is the data transfer rate that all stations in a basic service set (BSS) can use to receive frames from the wireless medium.

Represents an error occuring during WLAN operations which indicate their failure via a .

Gets the WLAN reason code.

The WLAN reason code.

Gets a message that describes the reason code.

The error message that explains the reason for the exception, or an empty string("").

Defines reasons for a failure of a WLAN operation.

Corresponds to the native reason code identifiers (WLAN_REASON_CODE_xxx identifiers).

Contains information about connection related notifications.

Corresponds to the native WLAN_CONNECTION_NOTIFICATION_DATA type. On Windows XP SP 2, only is supported.

The name of the profile used for the connection. Profile names are case-sensitive.

The SSID of the association.

The BSS network type.

Indicates whether security is enabled for this connection.

Indicates the reason for an operation failure. This field has a value of for all connection-related notifications except . If the connection fails, this field indicates the reason for the failure.

This field contains the XML presentation of the profile used for discovery, if the connection succeeds.

Indicates the state of an interface.

Corresponds to the native WLAN_INTERFACE_STATE type.

The interface is not ready to operate.

The interface is connected to a network.

The interface is the first node in an ad hoc network. No peer has connected.

The interface is disconnecting from the current network.

The interface is not connected to any network.

The interface is attempting to associate with a network.

Auto configuration is discovering the settings for the network.

The interface is in the process of authenticating.

Contains the SSID of an interface.

The length, in bytes, of the array.

The SSID.

Defines an 802.11 PHY and media type.

Corresponds to the native DOT11_PHY_TYPE type.

Specifies an unknown or uninitialized PHY type.

Specifies any PHY type.

Specifies a frequency-hopping spread-spectrum (FHSS) PHY. Bluetooth devices can use FHSS or an adaptation of FHSS.

Specifies a direct sequence spread spectrum (DSSS) PHY.

Specifies an infrared (IR) baseband PHY.

Specifies an orthogonal frequency division multiplexing (OFDM) PHY. 802.11a devices can use OFDM.

Specifies a high-rate DSSS (HRDSSS) PHY.

Specifies an extended rate PHY (ERP). 802.11g devices can use ERP.

Specifies the start of the range that is used to define PHY types that are developed by an independent hardware vendor (IHV).

Specifies the end of the range that is used to define PHY types that are developed by an independent hardware vendor (IHV).

Defines a basic service set (BSS) network type.

Corresponds to the native DOT11_BSS_TYPE type.

Specifies an infrastructure BSS network.

Specifies an independent BSS (IBSS) network.

Specifies either infrastructure or IBSS network.

Contains association attributes for a connection

Corresponds to the native WLAN_ASSOCIATION_ATTRIBUTES type.

The SSID of the association.

Specifies whether the network is infrastructure or ad hoc.

The BSSID of the association.

The physical type of the association.

The position of the value in the structure containing the list of PHY types.

The receiving rate of the association.

The transmission rate of the association.

Gets the BSSID of the associated access point.

The BSSID.

Defines the mode of connection.

Corresponds to the native WLAN_CONNECTION_MODE type.

A profile will be used to make the connection.

A temporary profile will be used to make the connection.

Secure discovery will be used to make the connection.

Unsecure discovery will be used to make the connection.

A connection will be made automatically, generally using a persistent profile.

Not used.

Defines a wireless LAN authentication algorithm.

Corresponds to the native DOT11_AUTH_ALGORITHM type.

Specifies an IEEE 802.11 Open System authentication algorithm.

Specifies an 802.11 Shared Key authentication algorithm that requires the use of a pre-shared Wired Equivalent Privacy (WEP) key for the 802.11 authentication.

Specifies a Wi-Fi Protected Access (WPA) algorithm. IEEE 802.1X port authentication is performed by the supplicant, authenticator, and authentication server. Cipher keys are dynamically derived through the authentication process. This algorithm is valid only for BSS types of . When the WPA algorithm is enabled, the 802.11 station will associate only with an access point whose beacon or probe responses contain the authentication suite of type 1 (802.1X) within the WPA information element (IE).

Specifies a WPA algorithm that uses preshared keys (PSK). IEEE 802.1X port authentication is performed by the supplicant and authenticator. Cipher keys are dynamically derived through a preshared key that is used on both the supplicant and authenticator. This algorithm is valid only for BSS types of . When the WPA PSK algorithm is enabled, the 802.11 station will associate only with an access point whose beacon or probe responses contain the authentication suite of type 2 (preshared key) within the WPA IE.

This value is not supported.

Specifies an 802.11i Robust Security Network Association (RSNA) algorithm. WPA2 is one such algorithm. IEEE 802.1X port authentication is performed by the supplicant, authenticator, and authentication server. Cipher keys are dynamically derived through the authentication process. This algorithm is valid only for BSS types of . When the RSNA algorithm is enabled, the 802.11 station will associate only with an access point whose beacon or probe responses contain the authentication suite of type 1 (802.1X) within the RSN IE.

Specifies an 802.11i RSNA algorithm that uses PSK. IEEE 802.1X port authentication is performed by the supplicant and authenticator. Cipher keys are dynamically derived through a preshared key that is used on both the supplicant and authenticator. This algorithm is valid only for BSS types of . When the RSNA PSK algorithm is enabled, the 802.11 station will associate only with an access point whose beacon or probe responses contain the authentication suite of type 2(preshared key) within the RSN IE.

Indicates the start of the range that specifies proprietary authentication algorithms that are developed by an IHV.

This enumerator is valid only when the miniport driver is operating in Extensible Station (ExtSTA) mode.

Indicates the end of the range that specifies proprietary authentication algorithms that are developed by an IHV.

This enumerator is valid only when the miniport driver is operating in Extensible Station (ExtSTA) mode.

Defines a cipher algorithm for data encryption and decryption.

Corresponds to the native DOT11_CIPHER_ALGORITHM type.

Specifies that no cipher algorithm is enabled or supported.

Specifies a Wired Equivalent Privacy (WEP) algorithm, which is the RC4-based algorithm that is specified in the 802.11-1999 standard. This enumerator specifies the WEP cipher algorithm with a 40-bit cipher key.

Specifies a Temporal Key Integrity Protocol (TKIP) algorithm, which is the RC4-based cipher suite that is based on the algorithms that are defined in the WPA specification and IEEE 802.11i-2004 standard. This cipher also uses the Michael Message Integrity Code (MIC) algorithm for forgery protection.

Specifies an AES-CCMP algorithm, as specified in the IEEE 802.11i-2004 standard and RFC 3610. Advanced Encryption Standard (AES) is the encryption algorithm defined in FIPS PUB 197.

Specifies a WEP cipher algorithm with a 104-bit cipher key.

Specifies a Robust Security Network (RSN) Use Group Key cipher suite. For more information about the Use Group Key cipher suite, refer to Clause 7.3.2.9.1 of the IEEE 802.11i-2004 standard.

Specifies a Wifi Protected Access (WPA) Use Group Key cipher suite. For more information about the Use Group Key cipher suite, refer to Clause 7.3.2.9.1 of the IEEE 802.11i-2004 standard.

Specifies a WEP cipher algorithm with a cipher key of any length.

Specifies the start of the range that is used to define proprietary cipher algorithms that are developed by an independent hardware vendor (IHV).

Specifies the end of the range that is used to define proprietary cipher algorithms that are developed by an IHV.

Defines the security attributes for a wireless connection.

Corresponds to the native WLAN_SECURITY_ATTRIBUTES type.

Indicates whether security is enabled for this connection.

The authentication algorithm.

The cipher algorithm.

Defines the attributes of a wireless connection.

Corresponds to the native WLAN_CONNECTION_ATTRIBUTES type.

The state of the interface.

The mode of the connection.

The name of the profile used for the connection. Profile names are case-sensitive.

The attributes of the association.

The security attributes of the connection.

Contains information about a LAN interface.

The GUID of the interface.

The description of the interface.

The current state of the interface.

The header of the list returned by .

Contains basic information about a profile.

The name of the profile. This value may be the name of a domain if the profile is for provisioning. Profile names are case-sensitive.

Profile flags.

Flags that specifiy the miniport driver's current operation mode.

Specifies that the miniport driver supports the Extensible Station (ExtSTA) operation mode.

Specifies that the miniport driver supports the Network Monitor (NetMon) operation mode.

Defines the radio state of a wireless connection.

Corresponds to the native DOT11_RADIO_STATE enumeration.

Defines the radio state attributes for a wireless connection.

Corresponds to the native WLAN_PHY_RADIO_STATE structure.

Defines the radio state attributes for a wireless connection.

Corresponds to the native WLAN_RADIO_STATE type.

Represents a client to the Zeroconf (Native Wifi) service.

This class is the entrypoint to Native Wifi management. To manage WiFi settings, create an instance of this class.

Creates a new instance of a Native Wifi service client.

Closes the handle.

Gets a string that describes a specified reason code.

The reason code. The string.

Gets the WLAN interfaces.

The WLAN interfaces.

Represents a Wifi network interface.

Sets a parameter of the interface whose data type is .

The opcode of the parameter. The value to set.

Gets a parameter of the interface whose data type is .

The opcode of the parameter. The integer value.

Requests a scan for available networks. The method returns immediately. Progress is reported through the event.

Converts a pointer to a available networks list (header + entries) to an array of available network entries.

A pointer to an available networks list's header. An array of available network entries.

Retrieves the list of available networks.

Controls the type of networks returned. A list of the available networks.

Converts a pointer to a BSS list (header + entries) to an array of BSS entries.

A pointer to a BSS list's header. An array of BSS entries.

Retrieves the basic service sets (BSS) list of all available networks.

Retrieves the basic service sets (BSS) list of the specified network.

Specifies the SSID of the network from which the BSS list is requested. Indicates the BSS type of the network. Indicates whether security is enabled on the network.

Connects to a network defined by a connection parameters structure.

The connection paramters.

Requests a connection (association) to the specified wireless network.

The method returns immediately. Progress is reported through the event.

Connects (associates) to the specified wireless network, returning either on a success to connect or a failure.

Connects to the specified wireless network.

The method returns immediately. Progress is reported through the event.

Disconnects to a network

Deletes a profile.

The name of the profile to be deleted. Profile names are case-sensitive. On Windows XP SP2, the supplied name must match the profile name derived automatically from the SSID of the network. For an infrastructure network profile, the SSID must be supplied for the profile name. For an ad hoc network profile, the supplied name must be the SSID of the ad hoc network followed by -adhoc.

Sets the profile.

The flags to set on the profile. The XML representation of the profile. On Windows XP SP 2, special care should be taken to adhere to its limitations. If a profile by the given name already exists, then specifies whether to overwrite it (if true) or return an error (if false). The resulting code indicating a success or the reason why the profile wasn't valid.

Gets the profile's XML specification.

The name of the profile. The XML document.

Gets the information of all profiles on this interface.

The profiles information.

Enqueues a notification event to be processed serially.

Occurs when an event of any kind occurs on a WLAN interface.

Occurs when a WLAN interface changes connection state.

Occurs when a WLAN operation fails due to some reason.

Gets or sets a value indicating whether this is automatically configured.

true if "autoconf" is enabled; otherwise, false.

Gets or sets the BSS type for the indicated interface.

The type of the BSS.

Gets the state of the interface.

The state of the interface.

Gets the channel.

The channel. Not supported on Windows XP SP2.

Gets the RSSI.

The RSSI. Not supported on Windows XP SP2.

Gets the radio state.

The radio state. Not supported on Windows XP.

Gets the current operation mode.

The current operation mode. Not supported on Windows XP SP2.

Gets the attributes of the current connection.

The current connection attributes. An exception with code 0x0000139F (The group or resource is not in the correct state to perform the requested operation.) will be thrown if the interface is not connected to a network.

Gets the network interface of this wireless interface.

The network interface allows querying of generic network properties such as the interface's IP address.

The GUID of the interface (same content as the value).

The description of the interface. This is a user-immutable string containing the vendor and model name of the adapter.

The friendly name given to the interface by the user (e.g. "Local Area Network Connection").

Represents a method that will handle events.

The notification data.

Represents a method that will handle events.

The notification data. The notification data.

Represents a method that will handle events.

The notification data. The reason code.

Custom Exception to catch Wlan Problems with special Utilities (Lenovo etc.)

Parameterless Constructor for WlanInterfaceException

Constructor for WlanInterfaceException

Inner Causing Exception