Baca dalam bahasa Inggris

Bagikan melalui


Metode IDiscFormat2Data::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_DF2DATA_CLIENT_NAME_IS_NOT_VALID
Nama klien tidak valid.

Nilai: 0xC0AA0211

E_IMAPI_DF2DATA_WRITE_IN_PROGRESS
Saat ini ada operasi tulis yang sedang berlangsung.

Nilai: 0xC0AA0500

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

IDiscFormat2Data

IDiscFormat2Data::get_ClientName