On the ITScriptNet client, you can specify a Device Alias on the Configuration screen. This Alias is saved into each collected data record and can be used to identify which device was used to collect a specific data record.
The Device Alias is also used as part of the filename for Image Capture or Digital Ink, along with a date/time stamp. This means that if you use a character in the Alias that is not a valid filename character, you will have problems saving the captured images.
What are the valid and invalid characters for a filename on a Windows CE/PocketPC/Windows Mobile device? Although it seems like an easy question to answer, the details turn out to be difficult to pin down. The Microsoft Knowledge Base has several articles about filenaming conventions, mostly with regards to the PC. Here are a few:
Errors Creating Files or Folders in the Root Directory
Naming a File
However, these articles list differing information on which characters are allowed. Are '?' and '*' allowed or not?
With the .Net Compact Framework 2.0 and higher, there is a function called GetInvalidFileNameChars which is supposed to return the list of invalid file name characters.
We created a test program using this function, and it returned the following invalid characters.
All characters between 0 and 31, along with the " < > | characters.
However, we tested creating files on a PocketPC device and determined that the ? * : \ / characters are also not allowed, even though they were not returned by GetInvalidFileNameChars.
So what is the answer to the question, what characters are not allowed in a Windows CE/PocketPC/Windows Mobile filename? It appears these are the invalid characters:
" < > | ? * : \ / and all between 0 and 31.
Avoid using any of these characters in your Device Alias to prevent problems saving Image Capture or Digital Ink characters.
We have added a pair of knowledge base articles describing this issue.
INFO: Invalid Filename Characters for Windows CE / PocketPC / Windows Mobile.
PROBLEM: Unable to Save Image error with Image Capture or Digital Ink.