IFsiDirectoryItem::Add method (imapi2fs.h)
Adds a file or directory described by the IFsiItem object to the file system image.
Syntax
HRESULT Add(
[in] IFsiItem *item
);
Parameters
[in] item
An IFsiItem interface of the IFsiFileItem or IFsiDirectoryItem to add to the file system image.
Return value
S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:
| Return code | Description |
|---|---|
|
Pointer is not valid.
Value: 0x80004003 |
|
Path '%1!s!' is badly formed or contains invalid characters.
Value: 0xC0AAB110 |
|
Cannot read data from stream supplied for file '%1!ls!'.
Value: 0xC0AAB129 |
|
ls!' name already exists.
Value: 0xC0AAB112 |
|
Attempt to add '%1!ls!' failed: cannot create a file-system-specific unique name for the %2!ls! file system.
Value: 0xC0AAB113 |
|
Adding '%1!ls!' would result in a result image having a size larger than the current configured limit.
Value: 0xC0AAB120 |
|
ISO9660 is limited to 8 levels of directories.
Value: 0xC0AAB131 |
|
This file system image has too many directories for the %1!ls! file system.
Value: 0xC0AAB130 |
|
The directory '%1!s!' not found in FileSystemImage hierarchy.
Value: 0xC0AAB11A |
|
This file or directory is not part of the file system. It must be added to complete this operation.
Value: 0xC0AAB10B |
|
FileSystemImage object is in read only mode.
Value: 0xC0AAB102 |
|
Adding this file or directory would result in a result image having a size larger than the current configured limit.
Value: 0xC0AAB120 |
|
Failed to allocate the required memory.
Value: 0x8007000E |
Remarks
To create a directory item or file item, call the IFileSystemImage::CreateDirectoryItem or IFileSystemImage::CreateFileItem method, respectively.
Once an item is added to the file system image, the IFsiFileItem::get_Data property becomes read-only.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | imapi2fs.h |