Metode IDiscFormat2TrackAtOnce::p ut_ClientName (imapi2.h)

Artikel
08/24/2023

Mengatur nama klien yang mudah diingat.

Sintaks

HRESULT put_ClientName(
  [in] BSTR value
);

Parameter

[in] value

Nama aplikasi klien.

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_OUTOFMEMORY	Gagal mengalokasikan memori yang diperlukan. Nilai: 0x8007000E
E_IMAPI_DF2TAO_CLIENT_NAME_IS_NOT_VALID	Nama klien tidak valid. Nilai: 0xC0AA050F
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS	Operasi tulis sedang berlangsung. Nilai: 0xC0AA0500
E_IMAPI_DF2TAO_MEDIA_IS_PREPARED	Operasi yang diminta tidak valid ketika media telah "disiapkan" tetapi tidak dirilis. Nilai: 0xC0AA0503

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


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

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::get_ClientName

Share via