Функция DRMCreateLicenseStorageSession (msdrm.h)

Статья
02/29/2024

[Пакет SDK ДЛЯ AD RMS с функциональными возможностями, предоставляемыми

клиент в Msdrm.dll доступен для использования в Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 и Windows 8. Он может быть изменен или

недоступно в последующих версиях. Вместо этого используйте пакет SDK 2.1 служб Active Directory Rights Management.

который использует функциональные возможности, предоставляемые клиентом в Msipc.dll.]

Функция DRMCreateLicenseStorageSession создает сеанс хранилища лицензий, необходимый для получения лицензии или управления ими.

Синтаксис

DRMEXPORT HRESULT UDAPICALL DRMCreateLicenseStorageSession(
  [in]  DRMENVHANDLE hEnv,
  [in]  DRMHANDLE    hDefaultLibrary,
  [in]  DRMHSESSION  hClient,
  [in]  UINT         uFlags,
  [in]  PWSTR        wszIssuanceLicense,
  [out] DRMHSESSION  *phLicenseStorage
);

Параметры

[in] hEnv

Дескриптор среды AD RMS. Этот дескриптор получен с помощью функции DRMInitEnvironment .

[in] hDefaultLibrary

Дескриптор библиотеки по умолчанию. Этот дескриптор получен с помощью функции DRMInitEnvironment .

[in] hClient

Дескриптор сеанса клиента. Этот дескриптор получен с помощью функции DRMCreateClientSession .

[in] uFlags

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

[in] wszIssuanceLicense

Указатель на строку Юникода, завершающуюся null, которая содержит подписанную лицензию на выдачу. Созданный сеанс хранилища лицензий связан с этой лицензией на выдачу.

[out] phLicenseStorage

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

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

Если функция завершается успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Сеанс хранилища лицензий используется, среди прочего, для получения, удаления и перечисления лицензий. Для фактической привязки к лицензии и реализации ее прав приложение должно использовать DRMCreateBoundLicense.

Дескриптор среды и дескриптор библиотеки по умолчанию создаются с помощью DRMInitEnvironment.

Дескриптор, возвращаемый в параметре phLicenseStorage , должен быть передан функции DRMCloseSession , если сеанс хранилища лицензий больше не нужен.