GUID (Standard 8 Module Reference)

7/8/2014

Review the applicable Embedded Core modules and any examples for the GUID setting in Windows Embedded 8 Standard (Standard 8).

This setting contains a globally unique identifier (GUID) of an icon to be shown in the notification area or for a class or type of sensor.

In Windows Embedded 8 Standard (Standard 8), up to four system notification icons are shown in the visible portion of the system notification area. By default, these icons are Action Center, Battery (if the system hardware includes battery support), Network, and Volume. You can configure another icon to appear in place of the Action Center and Battery icons.

For mobile devices, we recommend that you include a battery indicator that is visible at all times, such as the default Battery system notification icon.

The GUID for the icon is contained in the application specified in Path. The GUID item in the NOTIFYICONDATA shell structure contains a registered GUID that identifies the icon. For information about finding the GUID for your icon, see NOTIFYICONDATA Structure. For third-party applications, contact your application provider to find out if your application uses this structure and to obtain the GUID.

Modules

The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.

Module

Path

Setting Description

Proximity, Sensor and Location

Features/Natural User Interface/Proximity, Sensor and Location/SensorPermissions/Sensor/GUID

Specifies a class or type of sensor. Use it with GUIDClassification to enable or disable a class or type of sensor.

For information about sensor categories and types, see Sensor Categories, Types, and Data Fields on MSDN.

Shell-Setup

Products/Embedded Core/Shell-Setup/NotificationArea/PromotedIcon1/GUID

Specifies an icon to be shown in the visible system notification area on the taskbar in place of the Action Center icon. Do not create an empty value for this setting.

Shell-Setup

Products/Embedded Core/Shell-Setup/NotificationArea/PromotedIcon2/GUID

Specifies an icon to be shown in the visible system notification area on the taskbar in place of the Battery icon. Do not create an empty value for this setting.

XML Example

These XML examples show how to use the GUID setting.

Notification Area

The following XML example shows how to promote two other notification icons to be visible in place of the Action Center and Battery icons.

<NotificationArea>
     <PromotedIcon1>
       <Path>%PROGRAMFILES%\Fabrikam\Application1.exe</Path>
       <GUID>{d8742dcb-3e6a-4b3c-b3fe-374623cdcf06}</GUID>
     </PromotedIcon1>
     <PromotedIcon2>
       <Path>%PROGRAMFILES%\Fabrikam\Application2.exe</Path>
       <GUID>{a1bc23cb-3456-bcde-abcd-feb363cacc88}</GUID>
     </PromotedIcon2>
</NotificationArea>

Sensor

The following XML example shows how to use GUID and GUIDClassification to enable speedometers, as described in Motion Category in Sensor Categories, Types, and Data Fields on MSDN.

<SensorPermissions>
    <Sensor wcm:action="add">
        <Order>1</Order>
        <GUID>{6BD73C1F-0BB4-4310-81B2-DFC18A52BF94}</GUID>
        <GUIDClassification>Type</GUIDClassification>
        <Enable>false</Enable>
    </Sensor>
</SensorPermissions>

See Also

Reference

Path
Enable
Thin Client Template

Concepts

Embedded Core Settings
Feature Module Settings