IFsiDirectoryItem::get_Item-Methode (imapi2fs.h)

Artikel
02/26/2024

Ruft das angegebene Verzeichnis- oder Dateielement aus dem Dateisystemimage ab.

Syntax

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

Parameter

[in] path

Zeichenfolge, die den Pfad zum abzurufenden Element enthält.

[out] item

Eine IFsiItem-Schnittstelle des angeforderten Verzeichnisses oder Dateielements.

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	Beschreibung
IMAPI_E_INVALID_PATH	Pfad '%1!s!' ist schlecht formatiert oder enthält ungültige Zeichen. Wert: 0xC0AAB110
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
IMAPI_E_INVALID_PARAM	Der für den Parameter %1!ls! angegebene Wert ist ungültig. Wert: 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND	Element %1!ls! kann in der FileSystemImage-Hierarchie nicht gefunden werden. Wert: 0xC0AAB118
E_OUTOFMEMORY	Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E

Hinweise

Um zu bestimmen, ob es sich bei dem Element um ein Dateielement oder ein Verzeichniselement handelt, rufen Sie die IFsiItem::QueryInterface-Methode auf, um __uuidof(IFsiDirectoryItem) als Schnittstellenbezeichner zu übergeben. Wenn der Aufruf erfolgreich ist, ist das Element ein Verzeichniselement. Andernfalls ist das Element ein Dateielement.

Um alle untergeordneten Elemente aufzulisten, rufen Sie die IFsiDirectoryItem::get__NewEnum-Methode auf.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

IFsiDirectoryItem

IFsiFileItem

Freigeben über