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

Статья
08/24/2023

[Пакет 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.]

Функция DRMIsActivated указывает, активирован ли текущий пользователь или компьютер.

Синтаксис

DRMEXPORT HRESULT UDAPICALL DRMIsActivated(
  [in] DRMHSESSION      hClient,
  [in] UINT             uFlags,
  [in] DRM_ACTSERV_INFO *pActServInfo
);

Параметры

[in] hClient

Дескриптор сеанса клиента, созданный с помощью функции DRMCreateClientSession .

[in] uFlags

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

DRM_ACTIVATE_MACHINE

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

В клиенте служб Управления правами 1.0 компьютер считается активированным при наличии допустимого защищенного хранилища и допустимого сертификата компьютера.

DRM_ACTIVATE_GROUPIDENTITY

Текущий пользователь запрашивает состояние активации.

Текущий пользователь считается активированным, если хранилище сертификатов текущего пользователя имеет сертификат учетной записи прав , выданный на указанный идентификатор группы.

[in] pActServInfo

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

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

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

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

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

Эта функция использует сведения, содержащиеся в сеансе клиента. Если идентификатор пользователя, связанный с сеансом клиента, не совпадает с идентификатором вошедшего в систему пользователя, эта функция завершится ошибкой. Дополнительные сведения см. в разделе DRMCreateClientSession.