A newer version of this documentation is available.

View Latest

Service Taskbar

[Service Taskbar]
:ActionList=
IconColor=2|{THEME-DARK}||1|*
IconHidden=0
:IconSpeed=49
LogoColor=1
ModeMenu=0x007B
RefreshTimeout=30
UseEmptyIcon=1

ActionList

Set the action to do when clicking on the different menu commands.

#define DEFAULT_CMD_ABOUT "application self -dialog about"
#define DEFAULT_CMD_VIEW_TOKEN "application self -dialog viewtoken -number {token-number}"
#define DEFAULT_CMD_LOGON_TOKEN "application self -dialog enterpin -number {token-number} -force"
#define DEFAULT_CMD_LOGOUT_TOKEN "application self -logout -number {token-number}"

#Task names
case IDM_ABOUT: name = "about"; break;
case IDM_LINK_ADMIN: name = "admin"; break;
case IDM_LINK_HELP: name = "help"; break;
case IDM_LINK_SUPPORT: name = "support"; break;
case IDM_TOKEN_VIEW: name = "view-token"; break;
case IDM_TOKEN_LOGON: name = "logon-token"; break;
case IDM_TOKEN_LOGOUT: name = "logout-token"; break;

[Service Taskbar]
ActionList=about,About

IconColor

The IconColor parameter controls the taskbar progress icon animation.

[Service Taskbar]
IconColor=3

IconHidden

The IconHidden parameter shows or hides the icon in taskbar.

[Service Taskbar]
IconHidden=0

IconSpeed

The IconSpeed parameter controls the taskbar progress icon animation.

[Service Taskbar]
IconSpeed=99

LogoColor

The LogoColor parameter sets the taskbar logo icon.

[Service Taskbar]
LogoColor=0

ModeMenu

The ModeMenu parameter tells what items to show on the taskbar menu.

#define MENU_MODE_ABOUT       0x0001
#define MENU_MODE_EXIT        0x0002
#define MENU_MODE_PAUSE       0x0004
#define MENU_MODE_REFRESH     0x0008
#define MENU_MODE_TOKEN       0x0010
#define MENU_MODE_CERTIFICATE 0x0020
#define MENU_MODE_TRACE       0x0040

[Service Taskbar]
ModeMenu=0x007F
About

Show the Net iD Client About dialog box.

Exit

Show the Exit option to shut down the user service. This will shut down the complete user service, not only the taskbar service.

Pause

Add Pause and Continue to the menu. This lets the system pause the certificate and token service, that is, no access to the smart card.

Refresh

Add Refresh to the menu. Register certificates to CryptoAPI My store.

Token

Show a list of current tokens or slots.

Certificate

Show a list of current certificates and identities.

Trace

Show a list of trace options: enable, disable, clear, and open. Create log file in client application for troubleshooting.

RefreshTimeout

The RefreshTimeout parameter tells the number of seconds an application must wait for the user service to finish the possible update. Default is 30 seconds. The update means that the user service is doing something, such as loading certificates from the smart card. This is illustrated by a progress animation on the taskbar. Value 0 disables this feature.

[Service Taskbar]
RefreshTimeout=30

UseEmptyIcon

Use specific taskbar icons for Net iD Client when no certificate or token is available.

[Service Taskbar]
UseEmptyIcon=1

Values

0

As before.

1

Show a grayed-out icon when no certificate is available. This is the default value.

2

Show a grayed-out icon when no token is available.