Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The FileSystem configuration service provider queries the device file system for information about the files on the device. It can retrieve information about files in ROM, files in persistent store and files on any removable storage card that is present in the device. It retrieves information about files that are hidden from the user as well as those that are visible to the user.

The FileSystem configuration service provider is managed over the OMA DM protocol.

The default access role for the FileSystem configuration service provider is Manager. The default security role maps to each sub-element unless specific permission is granted to the sub-element.

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 about roles, see Security Rolesand Default Roles for Configuration Service Providers.

The following image shows the FileSystem configuration service provider management object in tree format as used by OMA DM.

./Vendor/MSFT/FileSystem

The root node of the FileSystem configuration service provider.

This node can have files and directories as child nodes.

Access type

Get

Data type

node

Occurs

One

./Vendor/MSFT/FileSystem/<file directory>

Placeholder for the name of a directory in the device file system.

Any <file directory> node can have directories and files as child nodes.

Get command will return the list of child node names under <file directory>.

Get with ?List=Struct will recursively return all children names including sub-directory names under <file directory>.

Note:
Get command with ?list=StructData query is not supported.

Access type

Get

Data type

node

Occurs

ZeroOrMore

./Vendor/MSFT/FileSystem/<file name>

Placeholder for the name of a single file in the device file system.

Access type

Get

Note:
The Get command is not supported on a <file name> node, only on the properties of the node.

Data type

bin

Occurs

ZeroOrMore

Remarks

Each interior node of the type <file directory> and <file name> in the FileSystem configuration service provider has a set of properties that can be queried. A Get command on the Microsoft property msft:SystemAttributes returns the file attributes of the directory or the file. The FileSystem configuration service provider also supports Get commands on the TStamp property of directories and files and on the Size property of files. The following table lists the properties.

Property Node Logical Response Notes

Name

File name

This property is not handled by the FileSystem configuration service provider.

Type

MIME type

All files will be application/octet-stream type. This value is stored as a constant string.

The FileSystem node will have an object identifier value of: com.microsoft/windowsmobile/1.0/FileSystemMOas the Type. For all other directories Type will be an empty string.

Format

bin

When binary data is sent over XML, it is b64 encoded. When binary data is sent over WBXML, bin format is used directly.

This property is not valid for nodes of the type <file directory>. For <file directory> the response is "node".

TStamp

Time stamp of the last write time

Value is in ISO 8601 format.

Note:
The last write time has different meanings depending on the file system. It usually means the last time the file was altered.

Size

File size, in bytes

The OMA DM protocol limits maximum integer size to 32 bits. This limitation restricts the returned Size value to a maximum of 4GB.

This property is not valid for nodes of the type <file directory>. 

msft:AccessRoles

Access roles

This property is handled outside the FileSystem configuration service provider. This is a Microsoft custom property that contains the access security roles for the node being queried and for any child nodes.

msft:SystemAttributes

File attributes

This value is an integer bit mask that corresponds to the FILE_ATTRIBUTE values and flags defined in the header file winnt.h.

See Also