CIM_DataFile is a type of logical file that is a named collection of data or executable code.
The behavior of the provider backing this class will be changed in future releases. Currently the provider returns both files on fixed disks as well as files on mapped logical disks. In the future, only instances of files on local fixed disks will be returned.
'The ChangeSecurityPermissions method changes the security permissions for the logical file specified in the object path. If the logical file is actually a directory, then ChangeSecurityPermissions will act recursively, changing the security permissions of all the files and sub-directories the directory contains. ChangeSecurityPermissions returns an integer value of 0 if the permissions were changed, and any other number to indicate an error. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The ChangeSecurityPermissionsEx method changes the security permissions for the logical file specified in the object path. If the logical file is actually a directory, then this method will act recursively, changing the security permissions of all the files and sub-directories the directory contains. ChangeSecurityPermissionsEx returns an integer value of 0 if the permissions were changed, and any other number to indicate an error. The ChangeSecurityPermissionsEx method is an extended version of the ChangeSecurityPermissions method. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The Compress method compresses the logical file (or directory) specified in the object path. Compress returns an integer value of 0 if the file was successfully compressed, and any other number to indicate an error. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The CompressEx method compresses the logical file (or directory) specified in the object path. CompressEx returns an integer value of 0 if the file was successfully compressed, and any other number to indicate an error. CompressEx is an extended version of the Compress method. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The Copy method copies the logical file or directory specified in the object path to the location specified by the input parameter. Copy returns an integer value of 0 if the file was successfully copied, and any other number to indicate an error. A copy is not supported if overwriting an existing logical file is required. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The CopyEx method copies the logical file or directory specified in the object path to the location specified by the FileName parameter. CopyEx returns an integer value of 0 if the file was successfully copied, and any other number to indicate an error. A copy is not supported if overwriting an existing logical file is required. CopyEx is an extended version of the Copy method. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The Delete method will delete the logical file (or directory) specified in the object path. Delete returns an integer value of 0 if the file was successfully deleted, and any other number to indicate an error. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The DeleteEx method will delete the logical file (or directory) specified in the object path. DeleteEx returns an integer value of 0 if the file was successfully deleted, and any other number to indicate an error. DeleteEx is an extended version of the Delete method. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The GetEffectivePermission method determines whether the caller has the aggregated permissions specified by the Permission argument not only on the file object, but on the share the file or directory resides on (if it is on a share).'
'The Rename method renames the logical file (or directory) specified in the object path. Rename returns an integer value of 0 if the file was successfully renamed, and any other number to indicate an error. A rename is not supported if the destination is on another drive or overwriting an existing logical file is required It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The TakeOwnerShip method obtains ownership of the logical file specified in the object path . If the logical file is actually a directory, then TakeOwnerShip will act recursively, taking ownership of all the files and sub-directories the directory contains. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The TakeOwnerShipEx method obtains ownership of the logical file specified in the object path. If the logical file is actually a directory, then this method will act recursively, taking ownership of all the files and sub-directories the directory contains. TakeOwnerShipEx returns an integer value of 0 on success, and any other number to indicate an error. TakeOwnerShipEx is an extended version of the TakeOwnerShip method. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The Uncompress method uncompresses the logical file (or directory) specified in the object path. Uncompress returns an integer value of 0 if the file was successfully decompressed, and any other number to indicate an error. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
'The UncompressEx method uncompresses the logical file (or directory) specified in the object path. UncompressEx returns an integer value of 0 if the file was successfully decompressed, and any other number to indicate an error. UncompressEx is an extended version of the Uncompress method. It returns one of the following integer values: 0 - The request was successful. 2 - Access was denied. 8 - An unspecified failure occurred. 9 - The name specified was invalid. 10 - The object specified already exists. 11 - The file system is not NTFS. 12 - The platform is not Windows NT or Windows 2000. 13 - The drive is not the same. 14 - The directory is not empty. 15 - There has been a sharing violation. 16 - The start file specified was invalid. 17 - A privilege required for the operation is not held. 21 - A parameter specified is invalid. '
['Success', 'Access Denied', 'Unspecified failure', 'Invalid object', 'Object already exists', 'File system not NTFS', 'Platform not NT/Windows 2000', 'Drive not the same', 'Directory not empty', 'Sharing violation', 'Invalid start file', 'Privilege not held', 'Invalid parameter']
['FILE_READ_DATA (file) or FILE_LIST_DIRECTORY (directory)', 'FILE_WRITE_DATA (file) or FILE_ADD_FILE (directory)', 'FILE_APPEND_DATA (file) or FILE_ADD_SUBDIRECTORY (directory)', 'FILE_READ_EA', 'FILE_WRITE_EA', 'FILE_EXECUTE (file) or FILE_TRAVERSE (directory)', 'FILE_DELETE_CHILD (directory)', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE']
CIMTYPE
'uint32'
Description
'The AccessMask property is a bit array representing the access rights to the given file or directory held by the user or group on whose behalf the instance is returned. This property is only supported under Windows NT and Windows 2000. On Windows 98 and on Windows NT/2000 FAT volumes, FULL_ACCESS is returned, indicating no security has been set on the object.'
'The CompressionMethod property is a free form string indicating the algorithm or tool used to compress the logical file. If it is not possible (or not desired) to describe the compression scheme (perhaps because it is not known), use the following words: "Unknown" to represent that it is not known whether the logical file is compressed or not, "Compressed" to represent that the file is compressed but either its compression scheme is not known or not disclosed, and "Not Compressed" to represent that the logical file is not compressed.'
'The EncryptionMethod property is a free form string indicating the algorithm or tool used to encrypt the logical file. If it is not possible (or not desired) to describe the encryption scheme (perhaps for security reasons), use the following words: "Unknown" to represent that it is not known whether the logical file is encrypted or not, "Encrypted" to represent that the file is encrypted but either its encryption scheme is not known or not disclosed, and "Not Encrypted" to represent that the logical file is not encrypted.'
'The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.'
'The Name property is a string representing the inherited name that serves as a key of a logical file instance within a file system. Full path names should be provided. Example: c:\winnt\system\win.ini'
'The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are "OK", "Degraded" and "Pred Fail". "Pred Fail" indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are "Error", "Starting", "Stopping" and "Service". The latter, "Service", could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither "OK" nor in one of the other states.'
'CIM_DataFile is a type of logical file that is a named collection of data or executable code. The behavior of the provider backing this class will be changed in future releases. Currently the provider returns both files on fixed disks as well as files on mapped logical disks. In the future, only instances of files on local fixed disks will be returned.'