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

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