Expand Minimize

IFileSystemImage::CreateDirectoryItem method

Create a directory item with the specified name.

Syntax


HRESULT CreateDirectoryItem(
  [in]   BSTR name,
  [out]  IFsiDirectoryItem **newItem
);

Parameters

name [in]

String that contains the name of the directory item to create.

newItem [out]

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 codeDescription
E_POINTER

Pointer is not valid.

Value: 0x80004003

IMAPI_E_INVALID_PARAM

The value specified for parameter %1!ls! is not valid.

Value: 0xC0AAB101

E_OUTOFMEMORY

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

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

IDL

Imapi2fs.idl

See also

IFileSystemImage
IFsiDirectoryItem

 

 

Community Additions

ADD
Show:
© 2015 Microsoft