EasClientDeviceInformation EasClientDeviceInformation EasClientDeviceInformation EasClientDeviceInformation Class

Provides the app with the ability to retrieve device information from the local device.

For an example of how mail clients can retrieve device information, see the EAS policies for mail clients sample.

Syntax

Declaration

public sealed class EasClientDeviceInformationpublic sealed class EasClientDeviceInformationPublic NotInheritable Class EasClientDeviceInformationpublic sealed class EasClientDeviceInformation

Constructors summary

Creates an instance of an object that allows the caller app to retrieve device information from the local device.

Properties summary

Returns the friendly name of the local device.

Returns the identifier of the local device.

Returns the operating system of the local device.

Returns the system firmware version of the local device.

Returns the system hardware version of the local device.

Returns the system manufacturer of the local device. Use this only if the SystemSku is empty.

Returns the system product name of the local device.

Returns the system SKU of the local device.

Constructors

  • EasClientDeviceInformation()
    EasClientDeviceInformation()
    EasClientDeviceInformation()
    EasClientDeviceInformation()

    Creates an instance of an object that allows the caller app to retrieve device information from the local device.

    public EasClientDeviceInformation()public New()Public Sub New()public EasClientDeviceInformation()

Properties

  • FriendlyName
    FriendlyName
    FriendlyName
    FriendlyName

    Returns the friendly name of the local device.

    public string FriendlyName { get; }public string FriendlyName { get; }Public ReadOnly Property FriendlyName As stringpublic string FriendlyName { get; }

    Property Value

    • string
      string
      string
      string

      The friendly name of the local device. This value might come from a NetBIOS computer name. The value must be less than 1024 characters.

  • Id
    Id
    Id
    Id

    Returns the identifier of the local device.

    public Guid Id { get; }public Guid Id { get; }Public ReadOnly Property Id As Guidpublic Guid Id { get; }

    Property Value

    • System.Guid
      System.Guid
      System.Guid
      System.Guid

      The identifier of the local device. The value range is 16 bytes.

    Remarks

    Windows Store app only. The Id property represents the DeviceId using the GUID truncated from the first 16 bytes of the SHA256 hash of the MachineID, User SID, and Package Family Name where the MachineID uses the SID of the local users group. Each component of the GUID is returned in network byte order.

  • OperatingSystem
    OperatingSystem
    OperatingSystem
    OperatingSystem

    Returns the operating system of the local device.

    public string OperatingSystem { get; }public string OperatingSystem { get; }Public ReadOnly Property OperatingSystem As stringpublic string OperatingSystem { get; }

    Property Value

    • string
      string
      string
      string

      The operating system of the local device.

  • SystemFirmwareVersion
    SystemFirmwareVersion
    SystemFirmwareVersion
    SystemFirmwareVersion

    Returns the system firmware version of the local device.

    public string SystemFirmwareVersion { get; }public string SystemFirmwareVersion { get; }Public ReadOnly Property SystemFirmwareVersion As stringpublic string SystemFirmwareVersion { get; }

    Property Value

    • string
      string
      string
      string

      The system firmware version of the local device.

    Remarks

    Note

    The SystemFirmwareVersion property is retrieved from the registry. If the registry can't be read for any reason, SystemFirmwareVersion is returned as an empty string.

  • SystemHardwareVersion
    SystemHardwareVersion
    SystemHardwareVersion
    SystemHardwareVersion

    Returns the system hardware version of the local device.

    public string SystemHardwareVersion { get; }public string SystemHardwareVersion { get; }Public ReadOnly Property SystemHardwareVersion As stringpublic string SystemHardwareVersion { get; }

    Property Value

    • string
      string
      string
      string

      The system hardware version of the local device.

    Remarks

    Note

    The SystemHardwareVersion property is retrieved from the registry. If the registry can't be read for any reason, SystemHardwareVersion is returned as an empty string.

  • SystemManufacturer
    SystemManufacturer
    SystemManufacturer
    SystemManufacturer

    Returns the system manufacturer of the local device. Use this only if the SystemSku is empty.

    public string SystemManufacturer { get; }public string SystemManufacturer { get; }Public ReadOnly Property SystemManufacturer As stringpublic string SystemManufacturer { get; }

    Property Value

    • string
      string
      string
      string

      The system manufacturer of the local device. The value must be less than 1024 characters.

    Remarks

    Windows Store app only. SystemManufacturer is retrieved from the registry. If the registry can't be read for any reason, SystemManufacturer is returned as an empty string.

  • SystemProductName
    SystemProductName
    SystemProductName
    SystemProductName

    Returns the system product name of the local device.

    public string SystemProductName { get; }public string SystemProductName { get; }Public ReadOnly Property SystemProductName As stringpublic string SystemProductName { get; }

    Property Value

    • string
      string
      string
      string

      The system product name of the local device. The value must be less than 1024 characters.

    Remarks

    Windows Store app only. Use this only if the SystemSku is empty. SystemProductName is retrieved from the registry. If the registry can't be read for any reason, SystemProductName is returned as an empty string.

  • SystemSku
    SystemSku
    SystemSku
    SystemSku

    Returns the system SKU of the local device.

    public string SystemSku { get; }public string SystemSku { get; }Public ReadOnly Property SystemSku As stringpublic string SystemSku { get; }

    Property Value

    • string
      string
      string
      string

      The system SKU of the local device.

    Remarks

    Windows Store app only. The SystemSku property is retrieved from the registry. If the registry can't be read for any reason, SystemSku is returned as an empty string. If SystemSku is not empty, SystemSku is recommended to be used as the Model string. Otherwise, you can use SystemManufacturer and SystemProductName to compose SystemSku.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.ThreadingAttribute

Details

Assembly

Windows.Security.ExchangeActiveSyncProvisioning.dll