IFsiDirectoryItem::get__NewEnum-Methode (imapi2fs.h)
Ruft eine Liste der untergeordneten Elemente ab, die im Verzeichnis im Dateisystemimage enthalten sind.
Syntax
HRESULT get__NewEnum(
[out] IEnumVARIANT **NewEnum
);
Parameter
[out] NewEnum
Eine IEnumVariant-Schnittstelle , die Sie verwenden, um die untergeordneten Elemente aufzulisten, die im Verzeichnis enthalten sind. Die Elemente der Enumeration sind Varianten, deren Typ VT_BSTR ist. Verwenden Sie den bstrVal-Member , um den Pfad zum untergeordneten Element 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 Celt - und pceltFetched-Parameter werden von IEnumVariant definiert.
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 | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
Hinweise
Die Enumeration ist eine Momentaufnahme der untergeordneten Elemente, die zum Zeitpunkt des Aufrufs im Verzeichnis enthalten sind, und spiegelt keine untergeordneten Elemente wider, die hinzugefügt und entfernt werden.
Informationen zum Abrufen eines einzelnen Elements finden Sie in der Eigenschaft IFsiDirectoryItem::get_Item .
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 |