IFsiNamedStreams::get__NewEnum-Methode (imapi2fs.h)
Ruft eine IEnumVARIANT-Liste der benannten Streams ab, die einer Datei im Dateisystemimage zugeordnet sind.
Syntax
HRESULT get__NewEnum(
[out, optional] IEnumVARIANT **NewEnum
);
Parameter
[out, optional] NewEnum
Zeiger auf einen Zeiger auf eine IEnumVariant-Schnittstelle , die verwendet wird, um die benannten Streams aufzulisten, die einer Datei zugeordnet sind. Die Elemente der Enumeration sind Varianten, deren Typ VT_BSTR ist. Verwenden Sie das bstrVal-Element , um den Pfad zum benannten Stream abzurufen.
Rückgabewert
S_OK wird zurückgegeben, wenn die Anzahl der angeforderten Elemente (celt) erfolgreich zurückgegeben wird oder die Anzahl der zurückgegebenen Elemente (pceltFetched) kleiner als die Anzahl der angeforderten Elemente ist. Die Parameter celt und pceltFetched werden durch IEnumVariant definiert.
Andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Zeiger ist ungültig. |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers. |
Hinweise
Die Enumeration ist eine Momentaufnahme der benannten Streams, die der Datei zum Zeitpunkt des Aufrufs zugeordnet sind, und spiegelt keine benannten Datenströme wider, die später hinzugefügt oder entfernt werden.
Verwenden Sie zum Abrufen eines einzelnen benannten Streams die IFsiNamedStreams::get_Item-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 von diesem Updatepaket bereitgestellten Features 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 |