IFsiDirectoryItem::get_Item method

Retrieves the specified directory or file item from file system image.

Syntax


HRESULT get_Item(
  [in]  BSTR     path,
  [out] IFsiItem **item
);

Parameters

path [in]

String that contains the path to the item to retrieve.

item [out]

An IFsiItem interface of the requested directory or file item.

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_ITEM_NOT_FOUND

Cannot find item %1!ls! in FileSystemImage hierarchy.

Value: 0xC0AAB118

E_OUTOFMEMORY

Failed to allocate necessary memory.

Value: 0x8007000E

 

Remarks

To determine whether the item is a file item or directory item, call the IFsiItem::QueryInterface method passing __uuidof(IFsiDirectoryItem) as the interface identifier. If the call succeeds, the item is a directory item; otherwise, the item is a file item.

To enumerate all children, call the IFsiDirectoryItem::get__NewEnum method.

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
IFsiFileItem

 

 

Community Additions

ADD
Show: