Freigeben über

IFsiDirectoryItem::Remove-Methode (imapi2fs.h)

  • Artikel

Entfernt das angegebene Element aus dem Dateisystemimage.

Syntax

HRESULT Remove(
  [in] BSTR path
);

Parameter

[in] path

Zeichenfolge, die den relativen Pfad des zu entfernenden Elements enthält. Der Pfad ist relativ zum aktuellen Verzeichniselement.

Geben Sie den vollständigen Pfad an, wenn Sie diese Methode aus dem Stammverzeichniselement aufrufen.

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_OUTOFMEMORY
 Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.

Wert: 0x8007000E
IMAPI_E_INVALID_PARAM
 Der für den Parameter %1!ls! angegebene Wert ist ungültig.

Wert: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM
 ls!" ist nicht Teil des Dateisystems. Sie muss hinzugefügt werden, um diesen Vorgang abzuschließen.

Wert: 0xC0AAB10B
IMAPI_E_READONLY
 Das FileSystemImage-Objekt befindet sich im schreibgeschützten Modus.

Wert: 0xC0AAB102
IMAPI_E_DIR_NOT_EMPTY
 Das Verzeichnis %1!s! ist nicht leer.

Wert: 0xC0AAB10A
IMAPI_E_FSI_INTERNAL_ERROR
 Interner Fehler: %1!ls!.

Wert: 0xC0AAB100

Hinweise

Diese Methode kann nur für Verzeichniselemente aufgerufen werden, die im Dateisystemimage vorhanden sind.

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

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::RemoveTree