Metode IDiscFormat2Data::p ut_ClientName (imapi2.h)
Mengatur nama klien yang mudah diingat.
HRESULT put_ClientName(
[in] BSTR value
);
[in] value
Nama aplikasi klien. Tidak boleh NULL atau string kosong.
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 |
---|---|
|
Gagal mengalokasikan memori yang diperlukan.
Nilai: 0x8007000E |
|
Nama klien tidak valid.
Nilai: 0xC0AA0211 |
|
Saat ini ada operasi tulis yang sedang berlangsung.
Nilai: 0xC0AA0500 |
Nama ini digunakan ketika operasi tulis meminta akses eksklusif ke perangkat. Properti IDiscRecorder2::get_ExclusiveAccessOwner berisi nama klien yang memiliki kunci.
Karena aplikasi apa pun dengan akses baca/tulis ke perangkat CDROM selama operasi tulis dapat menggunakan kode kontrol IOCTL_CDROM_EXCLUSIVE_ACCESS (kueri) (lihat Microsoft Windows Driver Development Kit (DDK)) untuk mengakses nama, penting bahwa nama mengidentifikasi program yang menggunakan antarmuka ini untuk menulis ke media. Nama dibatasi untuk kumpulan karakter yang sama seperti yang diperlukan oleh kode kontrol IOCTL_CDROM_EXCLUSIVE_ACCESS.
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 |