Metodo IClassFactory2::RequestLicKey (ocidl.h)

Articolo
02/29/2024

Crea una chiave di licenza che il chiamante può salvare e usare in un secondo momento per creare un'istanza dell'oggetto con licenza.

Sintassi

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

Parametri

[in] dwReserved

Questo parametro è riservato e deve essere zero.

[out] pBstrKey

Puntatore alla variabile allocata dal chiamante che riceve la chiave di licenza allocata dal chiamante in caso di esito positivo del ritorno da questo metodo. Questo parametro è impostato su NULL in qualsiasi errore.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	La chiave di licenza è stata creata correttamente.
E_NOTIMPL	Questa classe factory non supporta le chiavi di licenza di runtime.
E_POINTER	L'indirizzo passato in pbstrKey non è valido. Ad esempio, può essere NULL.
CLASS_E_NOTLICENSED	Questa classe factory supporta le licenze di runtime, ma il computer corrente non è concesso in licenza. Pertanto, una chiave di runtime non è disponibile in questo computer.

Commenti

Il chiamante può salvare la chiave di licenza per le chiamate successive a IClassFactory2::CreateInstanceLic per creare oggetti in un computer altrimenti non autorizzato.

Note ai chiamanti

Il chiamante deve liberare il BSTR con la funzione SysFreeString quando la chiave non è più necessaria. Il valore di fRuntimeKeyAvail viene restituito tramite una chiamata precedente a IClassFactory2::GetLicInfo.

Note per gli implementatori

Questo metodo alloca la chiave BSTR con SysAllocString o SysAllocStringLen e il chiamante diventa responsabile di questo BSTR dopo che questo metodo restituisce correttamente.

Questo metodo non deve essere implementato quando una classe factory non supporta le chiavi di licenza di runtime.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IClassFactory2

Condividi tramite