Metode IClassFactory2::RequestLicKey (ocidl.h)

Membuat kunci lisensi yang dapat disimpan dan digunakan penelepon nanti untuk membuat instans objek berlisensi.

Sintaks

HRESULT RequestLicKey(
  [in]  DWORD dwReserved,
  [out] BSTR  *pBstrKey
);

Parameter

[in] dwReserved

Parameter ini dicadangkan dan harus nol.

[out] pBstrKey

Penunjuk ke variabel yang dialokasikan penelepon yang menerima kunci lisensi yang dialokasikan callee pada pengembalian yang berhasil dari metode ini. Parameter ini diatur ke NULL pada kegagalan apa pun.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Kunci lisensi berhasil dibuat.
E_NOTIMPL	Pabrik kelas ini tidak mendukung kunci lisensi run-time.
E_POINTER	Alamat yang diteruskan dalam pbstrKey tidak valid. Misalnya, mungkin NULL.
CLASS_E_NOTLICENSED	Pabrik kelas ini mendukung lisensi run-time, tetapi komputer saat ini sendiri tidak dilisensikan. Dengan demikian, kunci run-time tidak tersedia di komputer ini.

Keterangan

Pemanggil dapat menyimpan kunci lisensi untuk panggilan berikutnya ke IClassFactory2::CreateInstanceLic untuk membuat objek pada komputer tanpa lisensi.

Catatan untuk Penelepon

Pemanggil harus membebaskan BSTR dengan fungsi SysFreeString ketika kunci tidak lagi diperlukan. Nilai fRuntimeKeyAvail dikembalikan melalui panggilan sebelumnya ke IClassFactory2::GetLicInfo.

Catatan untuk Pelaksana

Metode ini mengalokasikan kunci BSTR dengan SysAllocString atau SysAllocStringLen, dan pemanggil menjadi bertanggung jawab atas BSTR ini setelah metode ini berhasil dikembalikan.

Metode ini tidak perlu diimplementasikan ketika pabrik kelas tidak mendukung kunci lisensi run-time.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IClassFactory2