Windows Dev Center

IFsiDirectoryItem::AddFile method

Adds a file to the file system image.

Syntax


HRESULT AddFile(
  [in] BSTR    path,
  [in] IStream *fileData
);

Parameters

path [in]

String that contains the relative path of the directory to contain the new file.

Specify the full path when calling this method from the root directory item.

fileData [in]

An IStream interface of the file (data stream) to write to the media.

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
IMAPI_E_INVALID_PATH

Path '%1!s!' is badly formed or contains invalid characters.

Value: 0xC0AAB110

E_POINTER

Pointer is not valid.

Value: 0x80004003

IMAPI_E_INVALID_PARAM

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

Value: 0xC0AAB101

IMAPI_E_NOT_IN_FILE_SYSTEM

ls!' is not part of the file system. It must be added to complete this operation.

Value: 0xC0AAB10B

IMAPI_E_READONLY

FileSystemImage object is in read only mode.

Value: 0xC0AAB102

 

Remarks

The directory that will contain the new file must already exist within 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

IFsiDirectoryItem
IFsiDirectoryItem::Add
IFsiDirectoryItem::AddDirectory
IFsiDirectoryItem::Remove

 

 

Community Additions

ADD
Show:
© 2015 Microsoft