Partager via


Méthode IClassFactory2 ::RequestLicKey (ocidl.h)

Crée une clé de licence que l’appelant peut enregistrer et utiliser ultérieurement pour créer une instance de l’objet sous licence.

Syntaxe

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

Paramètres

[in] dwReserved

Ce paramètre est réservé et doit être égal à zéro.

[out] pBstrKey

Pointeur vers la variable allouée par l’appelant qui reçoit la clé de licence allouée par l’appelant en cas de retour réussi de cette méthode. Ce paramètre est défini sur NULL en cas de défaillance.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
La clé de licence a été créée avec succès.
E_NOTIMPL
Cette fabrique de classe ne prend pas en charge les clés de licence d’exécution.
E_POINTER
L’adresse passée dans pbstrKey n’est pas valide. Par exemple, il peut s’agir de NULL.
CLASS_E_NOTLICENSED
Cette fabrique de classe prend en charge les licences d’exécution, mais la machine actuelle elle-même n’est pas concédée sous licence. Par conséquent, une clé d’exécution n’est pas disponible sur cet ordinateur.

Remarques

L’appelant peut enregistrer la clé de licence pour les appels suivants à IClassFactory2 ::CreateInstanceLic afin de créer des objets sur un ordinateur sans licence.

Remarques aux appelants

L’appelant doit libérer le BSTR avec la fonction SysFreeString lorsque la clé n’est plus nécessaire. La valeur de fRuntimeKeyAvail est retournée via un appel précédent à IClassFactory2 ::GetLicInfo.

Remarques aux implémenteurs

Cette méthode alloue la clé BSTR avec SysAllocString ou SysAllocStringLen, et l’appelant devient responsable de ce BSTR une fois cette méthode retournée avec succès.

Cette méthode n’a pas besoin d’être implémentée lorsqu’une fabrique de classes ne prend pas en charge les clés de licence d’exécution.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ocidl.h

Voir aussi

IClassFactory2