Metode IDiscFormat2Data::CancelWrite (imapi2.h)

Artikel
08/24/2023

Membatalkan operasi tulis saat ini.

Sintaks

HRESULT CancelWrite();

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_IMAPI_DF2DATA_WRITE_NOT_IN_PROGRESS	Saat ini tidak ada operasi tulis yang sedang berlangsung. Nilai: 0xC0AA0401
E_FAIL	Kegagalan yang tidak ditentukan. Nilai: 0x80004005

Keterangan

Untuk membatalkan operasi tulis, Anda harus memanggil metode ini dari penanganan aktivitas DDiscFormat2DataEvents::Update yang Anda terapkan.

Perhatikan bahwa memanggil metode ini tidak segera membatalkan operasi tulis di semua media karena persyaratan khusus media. Misalnya, saat menulis ke CD, operasi tulis dapat dilanjutkan hingga tiga menit lagi.

Metode ini membuat media dalam keadaan tidak ditentukan. Untuk media yang dapat ditulis ulang, Anda harus memanggil metode IDiscFormat2Erase::EraseMedia setelah memanggil metode ini untuk menyiapkan media untuk digunakan di masa mendatang.

Persyaratan

Persyaratan	Nilai
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	imapi2.h

Lihat juga

DWriteEngine2Events

IDiscFormat2Data

IDiscFormat2Data::Write

Share via