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 |
---|---|
|
Kunci lisensi berhasil dibuat. |
|
Pabrik kelas ini tidak mendukung kunci lisensi run-time. |
|
Alamat yang diteruskan dalam pbstrKey tidak valid. Misalnya, mungkin NULL. |
|
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 |