Metode IFsiDirectoryItem::RemoveTree (imapi2fs.h)

Hapus pohon direktori yang ditentukan dari citra sistem file.

Sintaks

HRESULT RemoveTree(
  [in] BSTR path
);

Parameter

[in] path

String yang berisi nama direktori yang akan dihapus. Jalur relatif terhadap item direktori saat ini.

Mengembalikan nilai

S_OK dikembalikan pada keberhasilan, tetapi kode keberhasilan lainnya dapat dikembalikan sebagai hasil dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Menampilkan kode	Deskripsi
E_POINTER	Parameter jalur bukan penunjuk yang valid.
IMAPI_E_INVALID_PARAM	Nilai yang ditentukan untuk parameter %1!ls! tidak valid. Nilai: 0xC0AAB101
IMAPI_E_INVALID_PATH	Jalur '%1!s!' dibentuk dengan buruk atau berisi karakter yang tidak valid. Nilai: 0xC0AAB110
IMAPI_E_NOT_IN_FILE_SYSTEM	ls!' bukan bagian dari sistem file. Ini harus ditambahkan untuk menyelesaikan operasi ini. Nilai: 0xC0AAB10B
IMAPI_E_READONLY	Objek FileSystemImage berada dalam mode baca-saja. Nilai: 0xC0AAB102
IMAPI_E_DIR_NOT_FOUND	Direktori yang ditentukan tidak ada.
IMAPI_E_DIR_NOT_EMPTY	Direktori %1!s! tidak kosong. Nilai: 0xC0AAB10A
IMAPI_E_FSI_INTERNAL_ERROR	Terjadi kesalahan internal: %1!ls!. Nilai: 0xC0AAB100
IMAPI_E_NOT_DIR	Jalur yang ditentukan %1!ls! tidak mengidentifikasi direktori. Nilai: 0xC0AAB109

Keterangan

Item direktori harus ada dalam gambar sistem file.

Anda dapat menghapus seluruh gambar sistem file dengan memanggil metode ini untuk item direktori akar dan mengatur jalur ke pemisah jalur tunggal (\).

Persyaratan

Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi2fs.h

Lihat juga

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::AddTree

IFsiDirectoryItem::Remove