IFsiNamedStreams::get_Item-Methode (imapi2fs.h)
Ruft einen einzelnen benannten Stream ab, der einer Datei im Dateisystemimage zugeordnet ist.
Syntax
HRESULT get_Item(
[in] LONG index,
[out, optional] IFsiFileItem2 **item
);
Parameter
[in] index
Dieser Wert gibt die Position des benannten Datenstroms innerhalb der Auflistung an. Die Indexnummer ist nullbasiert, d. h. das erste Element befindet sich an Position 0 der Auflistung.
[out, optional] item
Zeiger auf einen Zeiger auf ein IFsiFileItem2-Objekt , das den benannten Stream an der vom Index angegebenen Position darstellt. Dieser Parameter wird auf NULL festgelegt, wenn sich der angegebene Index nicht innerhalb der Sammlungsgrenze befindet.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Zeiger ist ungültig. |
|
Der für den Parameter '%1!ls!' angegebene Wert ungültig. |
Hinweise
Wenn die Indexnummer negativ oder außerhalb des Bereichs liegt, gibt diese Methode den IMAPI_E_INVALID_PARAM zurück.
Um einen IEnumVARIANT-Enumerator für alle benannten Datenströme abzurufen, die einer Datei zugeordnet sind, verwenden Sie die IFsiNamedStreams::get__NewEnum-Methode .
Diese Methode wird in Windows Server 2003 mit Service Pack 1 (SP1), Windows XP mit Service Pack 2 (SP2) und Windows Vista über das Windows Feature Pack for Storage unterstützt. Alle Features dieses Updatepakets werden in Windows 7 und Windows Server 2008 R2 nativ unterstützt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2fs.h |