Skip to content

Latest commit

 

History

History
111 lines (91 loc) · 3.57 KB

nf-imapi2fs-ifsinamedstreams-get_item.md

File metadata and controls

111 lines (91 loc) · 3.57 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:imapi2fs.IFsiNamedStreams.get_Item
IFsiNamedStreams::get_Item (imapi2fs.h)
Retrieves a single named stream associated with a file in the file system image.
IFsiNamedStreams interface [IMAPI]
get_Item method
IFsiNamedStreams.get_Item
IFsiNamedStreams::get_Item
get_Item
get_Item method [IMAPI]
get_Item method [IMAPI]
IFsiNamedStreams interface
imapi.ifsinamedstreams_get_item
imapi2fs/IFsiNamedStreams::get_Item
imapi\ifsinamedstreams_get_item.htm
imapi
e5ab97cc-cc5a-4fc5-b79a-f1e0a8647c77
12/05/2018
IFsiNamedStreams interface [IMAPI],get_Item method, IFsiNamedStreams.get_Item, IFsiNamedStreams::get_Item, get_Item, get_Item method [IMAPI], get_Item method [IMAPI],IFsiNamedStreams interface, imapi.ifsinamedstreams_get_item, imapi2fs/IFsiNamedStreams::get_Item
imapi2fs.h
Windows
Windows Vista, Windows XP with SP2 [desktop apps only]
Windows Server 2003 [desktop apps only]
Imapi2fs.idl
Windows
19H1
IFsiNamedStreams::get_Item
imapi2fs/IFsiNamedStreams::get_Item
c++
APIRef
kbSyntax
COM
imapi2fs.h
IFsiNamedStreams.get_Item

IFsiNamedStreams::get_Item

-description

Retrieves a single named stream associated with a file in the file system image.

-parameters

-param index [in]

This value indicates the position of the named stream within the collection. The index number is zero-based, i.e. the first item is at location 0 of the collection.

-param item [out, optional]

Pointer to a pointer to an IFsiFileItem2 object representing the named stream at the position specified by index. This parameter is set to NULL if the specified index is not within the collection boundary.

-returns

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/value Description
E_POINTER
Value: 0x80004003
Pointer is not valid.
IMAPI_E_INVALID_PARAM
Value: 0xC0AAB101
The value specified for parameter '%1!ls!' is invalid.

-remarks

If the index number is negative or out of range, this method returns the IMAPI_E_INVALID_PARAM.

To fetch an IEnumVARIANT enumerator for all named streams associated with a file, use the IFsiNamedStreams::get__NewEnum method.

This method is supported in Windows Server 2003 with Service Pack 1 (SP1), Windows XP with Service Pack 2 (SP2), and Windows Vista via the Windows Feature Pack for Storage. All features provided by this update package are supported natively in Windows 7 and Windows Server 2008 R2.

-see-also

IFsiNamedStreams