Metode IDiscFormat2RawCD::p ut_ClientName (imapi2.h)

Mengatur nama klien yang mudah diingat.

Sintaks

HRESULT put_ClientName(
  [in] BSTR value
);

Parameter

[in] value

Nama aplikasi klien. Tidak boleh NULL atau string kosong.

Nilai kembali

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_OUTOFMEMORY	Gagal mengalokasikan memori yang diperlukan. Nilai: 0x8007000E
E_IMAPI_DF2RAW_CLIENT_NAME_IS_NOT_VALID	Nama klien tidak valid. Nilai: 0xC0AA0604
E_IMAPI_DF2RAW_WRITE_IN_PROGRESS	Saat ini ada operasi tulis yang sedang berlangsung. Nilai: 0xC0AA0600
E_IMAPI_DF2RAW_MEDIA_IS_PREPARED	Operasi yang diminta tidak valid ketika media telah "disiapkan" tetapi tidak dirilis. Nilai: 0xC0AA0603

Keterangan

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

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

IDiscFormat2RawCD

IDiscFormat2RawCD::get_ClientName