IFileSystemImage::CreateDirectoryItem method (imapi2fs.h)
Create a directory item with the specified name.
Syntax
HRESULT CreateDirectoryItem(
[in] BSTR name,
[out] IFsiDirectoryItem **newItem
);
Parameters
[in] name
String that contains the name of the directory item to create.
[out] newItem
An IFsiDirectoryItem interface of the new directory item. When done, call the IFsiDirectoryItem::Release method to release the interface.
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 |
|
The value specified for parameter %1!ls! is not valid.
Value: 0xC0AAB101 |
|
Failed to allocate the required memory.
Value: 0x8007000E |
Remarks
After setting properties on the IFsiDirectoryItem interface, call the IFsiDirectoryItem::Add method on the parent directory item to add it to the file system image.
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 |