Compartir a través de

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

  • Artículo

Crea una clave de licencia que el autor de la llamada puede guardar y usar más adelante para crear una instancia del objeto con licencia.

Sintaxis

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

Parámetros

[in] dwReserved

Este parámetro está reservado y debe ser cero.

[out] pBstrKey

Puntero a la variable asignada por el autor de la llamada que recibe la clave de licencia asignada por el autor de la llamada al devolver correctamente este método. Este parámetro se establece en NULL en cualquier error.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código devuelto Descripción
S_OK
 La clave de licencia se creó correctamente.
E_NOTIMPL
 Esta factoría de clases no admite claves de licencia en tiempo de ejecución.
E_POINTER
 La dirección pasada en pbstrKey no es válida. Por ejemplo, puede ser NULL.
CLASS_E_NOTLICENSED
 Esta factoría de clases admite licencias en tiempo de ejecución, pero la propia máquina actual no tiene licencia. Por lo tanto, una clave en tiempo de ejecución no está disponible en este equipo.

Comentarios

El autor de la llamada puede guardar la clave de licencia para las llamadas posteriores a IClassFactory2::CreateInstanceLic para crear objetos en un equipo sin licencia.

Notas a los autores de llamadas

El autor de la llamada debe liberar el BSTR con la función SysFreeString cuando la clave ya no es necesaria. El valor de fRuntimeKeyAvail se devuelve a través de una llamada anterior a IClassFactory2::GetLicInfo.

Notas para los implementadores

Este método asigna la clave BSTR con SysAllocString o SysAllocStringLen, y el autor de la llamada se hace responsable de este BSTR después de que este método devuelva correctamente.

Este método no se debe implementar cuando un generador de clases no admite claves de licencia en tiempo de ejecución.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IClassFactory2