FileOperation Configuration Service Provider
The FileOperation Configuration Service Provider manages files and directories on the device.
Note Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information, see Security Roles.
Note This Configuration Service Provider is not available on Windows Mobile-based Pocket PC.
Characteristics or parms for the FileOperation Configuration Service Provider contain an additional attribute called "translation" when specifying a parm or characteristic that contains a file name or directory. The two values for this attribute are "filesystem" and "install". A translation of type "filesystem" causes all file paths to be canonicalized (that is, double backslashes are removed). A translation of type "install" includes all the translations done for "filesystem", but also translates all CE Strings (for example, %CE2%) into the correct file path for the device. CabWizSP will automatically add the appropriate translation to file operations and registry keys in an .inf file.
The following table shows the default settings:
| Permissions | Read/Write |
| Data type | String |
| Roles allowed to query and update setting | Manager |
The following table shows the description for each path:
| Path | Description |
|---|---|
| * | Access for the entire file system.
This parm also allows the AuthenticatedUser role to query and update settings. |
| %CE18%\cemail.vol\* | Needed to protect all of the .vol databases stored at the root from being deleted by RAPI and DMProcessConfig calls. |
| %CE18%\mxip_initdb.vol\* | Needed to protect all of the .vol databases stored at the root from being deleted by RAPI and DMProcessConfig calls. |
| %CE18%\mxip_lang.vol\* | Needed to protect all of the .vol databases stored at the root from being deleted by RAPI and DMProcessConfig calls. |
| %CE18%\synckey.vol\* | Needed to protect all of the .vol databases stored at the root from being deleted by RAPI and DMProcessConfig calls. |
| %CE2%\AppMgr\* | Uninstall documents need to be protected so that they cannot be deleted or modified by anyone but the manager. |
| %CE2%\AppMgr\Install\* | This subdirectory needs to be accessible to User_Auth so that the application manager (AppMgr) for ActiveSync can put cab files here. |
| %CE2%\ConfigMgr\* | Rollback documents need to be protected so that they cannot be deleted or modified by anyone but the manager. |
| Windows\cdial.exe\* | Part of Exclusion list for file operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\connmgr.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\cpmpsl.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\cpmwarn.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\cprog.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\device.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\filesys.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\gwes.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\home.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting |
| Windows\NK.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\shell.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\srvtrust.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\start.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| Windows\telshell.exe\* | Part of Exclusion list for File Operations. The files in this list cannot be modified. So no roles are assigned to this setting. |
| %CE19%\Home\ | Application data for Home. This parm has a file semantic type, and also allows the Manager, AuthenticatedUser, and UnauthenticatedUser roles to query and update settings. |
| %CE19%\Sounds\. | Access role for access sounds application data directory. This parm has a file semantic type, and also allows the Manager, AuthenticatedUser, and UnauthenticatedUser roles to query and update settings. |
Characteristics
- Copy
Copies one file to another file. - Delete
Deletes a file. - Extract
Extracts the file specified by the Source parm from the currently open .cab file. The extracted file is placed in the file name and directory specified by the previous characteristic. The Extract characteristic can only be used in conjunction with a .cab file. - MakeDir
This characteristic should appear under any characteristic where the type is a file path ("%CE2%\files", for example). If the directory does not exist, MakeDir ensures that the directory is created. - Move
Moves one file to another name and/or location. - RemoveDir
Removes a directory. This command is only successful if there are no files or subdirectories in this directory. - Shortcut
Creates a shortcut to an executable on the device. Shortcuts should be placed in the appropriate directory in the Start Menu, under the Windows CE Directory Identifier (%CE17%).
Parms
- ForceDelete
This parm can be used in the Delete characteristic to delete the file even if the shared reference count is not zero. - NoOverwrite
This parm can be used in the Copy, Move, and Extract characteristics. If the destination file already exists, it is not replaced by this operation. - NoOverwriteIfnewer
This parm can be used in the Copy, Move, and Extract characteristics. If the destination file already exists and is newer than the source file, the destination file is not replaced by this operation. - NoTransaction
This parm can be used in the MakeDir, RemoveDir, Copy, Move, Extract, and Delete characteristics. If this parameter is set, no backup file is created for this operation. If the operation fails, the original file is not restored. This will also prevent the entry from appearing in the recovery file - SelfRegister
This parm can be used in the Copy, Move, and Extract characteristics to indicate that this file is a self-registering COM server. The installation routine attempts to call DLLRegisterServer in that DLL. If this is used together with Delete, the DllUnregisterServer is called. - Shared
This parm can be used in the Copy, Move, and Extract characteristics to indicate that this file is a shared component and updates the reference count. On uninstall, the reference count is decremented, and the file is deleted only if the count is zero. - Source
This parm can be used in the Shortcut, Copy, Extract, and Move characteristics to indicate the file that action will be taken upon. For example, Source indicates the original file in a Copy operation.
Elements
| Elements | Available |
|---|---|
| parm-query | No |
| noparm | No |
| nocharacteristic | No |
| characteristic-query | No |
For information about specific elements, see MSPROV DTD Elements.
See Also
Configuration Service Provider Reference for Windows Mobile Devices| FileOperation Configuration Service Provider Example
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.