Поделиться через

Метод IClassFactory2::RequestLicKey (ocidl.h)

  • Статья

Создает лицензионный ключ, который вызывающий объект может сохранить и использовать позже для создания экземпляра лицензированного объекта.

Синтаксис

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

Параметры

[in] dwReserved

Этот параметр зарезервирован и должен быть равен нулю.

[out] pBstrKey

Указатель на переменную, выделенную вызывающим объектом, которая получает выделенный вызывающим абонентом лицензионный ключ при успешном возвращении из этого метода. Этот параметр имеет значение NULL при любом сбое.

Возвращаемое значение

Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата Описание
S_OK
 Лицензионный ключ успешно создан.
E_NOTIMPL
 Эта фабрика классов не поддерживает ключи лицензий во время выполнения.
E_POINTER
 Адрес, переданный в pbstrKey , недопустим. Например, он может иметь значение NULL.
CLASS_E_NOTLICENSED
 Эта фабрика класса поддерживает лицензирование во время выполнения, но сам текущий компьютер не лицензирован. Таким образом, ключ времени выполнения недоступен на этом компьютере.

Комментарии

Вызывающий объект может сохранить лицензионный ключ для последующих вызовов IClassFactory2::CreateInstanceLic для создания объектов на компьютере без лицензии.

Примечания к вызывающим абонентам

Вызывающий объект должен освободить BSTR с помощью функции SysFreeString , если ключ больше не нужен. Значение fRuntimeKeyAvail возвращается при предыдущем вызове метода IClassFactory2::GetLicInfo.

Примечания для разработчиков

Этот метод выделяет ключ BSTR с помощью SysAllocString или SysAllocStringLen, и вызывающий объект становится ответственным за этот BSTR после успешного возврата этого метода.

Этот метод не требуется реализовывать, если фабрика классов не поддерживает ключи лицензий во время выполнения.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

См. также раздел

IClassFactory2