Active Directory Rights Management Services SDK

Active Directory Rights Management Services SDK 技术概述。

若要开发 Active Directory Rights Management Services SDK,需要以下标头:

有关此技术的编程指南,请参阅:

枚举

 
DRM_DISTRIBUTION_POINT_INFO

指定在调用 DRMGetIssuanceLicenseInfo 时要检索相关信息的分发点的类型。
DRM_STATUS_MSG

由自定义回调函数用来指定调用回调函数的原因。
DRM_USAGEPOLICY_TYPE

与 DRMGetUsagePolicy 和 DRMSetUsagePolicy 函数一起使用,以指定使用策略的类型。
DRMATTESTTYPE

DRMATTESTTYPE 枚举指定要为数据 Blob 创建哪种类型的签名。
DRMENCODINGTYPE

DRMENCODINGTYPE 枚举标识许可证中使用的可能编码类型。
DRMGLOBALOPTIONS

定义用于指定用于传输协议的协议以及是否使用服务器密码箱的值。 DRMSetGlobalOptions 函数使用此枚举。
DRMSECURITYPROVIDERTYPE

DRMSECURITYPROVIDERTYPE 枚举指定所使用的安全 DRM 环境的类型。
DRMSPECTYPE

DRMSPECTYPE 枚举指示使用哪种类型的安全或库提供程序。
DRMTIMETYPE

DRMTIMETYPE 枚举指定时间类型。

函数

 
DRMAcquireAdvisories

检索提交的许可证所需的吊销列表。
DRMAcquireIssuanceLicenseTemplate

从服务器异步检索颁发许可证模板。
DRMAcquireLicense

尝试异步获取最终用户许可证或客户端许可方证书。
DRMActivate

获取计算机的密码箱和计算机证书或用户的权限帐户证书。
DRMAddLicense

将最终用户许可证添加到临时或永久许可证存储。
DRMAddRightWithUser

向颁发许可证中的用户分配权限。
DRMAttest

DRMAttest 函数不再受支持,返回E_NOTIMPL。
DRMCALLBACK

AD RMS SDK 中包含的某些函数通过使用你必须实现的回调函数向应用程序提供状态信息和许可证。 回调语法如下所示。
DRMCheckSecurity

返回运行的任何安全检查级别的S_OK。
DRMClearAllRights

从现有颁发许可证中删除所有权限。
DRMCloseEnvironmentHandle

关闭环境句柄。
DRMCloseHandle

关闭使用 DRMLoadLibrary 加载的 DRMCreate* 函数和库创建的对象的句柄。
DRMClosePubHandle

关闭以前创建的 DRMPUBHANDLE。
DRMCloseQueryHandle

关闭未绑定许可证对象的句柄。
DRMCloseSession

关闭客户端会话或许可证存储会话。
DRMConstructCertificateChain

从任意数量的证书生成证书链。
DRMCreateBoundLicense

允许应用程序检查或行使对本地存储的许可证的权限。
DRMCreateClientSession

创建客户端会话,该会话托管许可证存储会话,并在激活和其他函数调用中使用。
DRMCreateEnablingBitsDecryptor

创建用于解密内容数据的解密对象。
DRMCreateEnablingBitsEncryptor

创建用于加密内容数据的 AD RMS 加密对象。
DRMCreateEnablingPrincipal

创建绑定到许可证所需的启用主体。
DRMCreateIssuanceLicense

从头开始、从模板或已签名的颁发许可证创建颁发许可证。
DRMCreateLicenseStorageSession

创建获取或操作许可证所需的许可证存储会话。
DRMCreateRight

创建将定义授予用户或组的权限的 XrML 权限。
DRMCreateUser

创建将被授予权限的用户。
DRMDecode

解码使用常用算法(如 base64)编码的字符串。
DRMDeconstructCertificateChain

从证书链中检索指定的证书。
DRMDecrypt

解密加密的内容。
DRMDeleteLicense

删除许可证、客户端许可方证书、吊销列表或颁发许可证模板。
DRMDuplicateEnvironmentHandle

创建环境句柄的副本。
DRMDuplicateHandle

创建 DRMHANDLE 的副本。
DRMDuplicatePubHandle

创建 DRMPUBHANDLE 的副本。
DRMDuplicateSession

复制客户端或许可证存储会话。
DRMEncode

使用公共编码方法(如 base64)对数据进行编码。
DRMEncrypt

加密数据。
DRMEnumerateLicense

枚举有效的许可证、计算机证书或权限帐户证书、当前用户的吊销列表或颁发许可证模板。
DRMGetApplicationSpecificData

检索任意应用程序特定信息的名称/值对。
DRMGetBoundLicenseAttribute

从许可证 XrML 检索绑定的许可证属性。
DRMGetBoundLicenseAttributeCount

检索许可证中某个属性的出现次数。
DRMGetBoundLicenseObject

从绑定许可证返回对象。
DRMGetBoundLicenseObjectCount

检索对象在许可证的指定分支中的出现次数。
DRMGetCertificateChainCount

检索证书链中的证书数。
DRMGetClientVersion

返回 Active Directory Rights Management Services 客户端软件的版本号,以及层次结构是用于生产还是预生产目的。
DRMGetEnvironmentInfo

返回有关安全环境的信息。
DRMGetInfo

检索有关加密或解密对象的信息。
DRMGetIntervalTime

检索在最终用户许可证必须续订之前可以经过的颁发天数。
DRMGetIssuanceLicenseInfo

从颁发许可证中检索各种信息。
DRMGetIssuanceLicenseTemplate

从现有颁发许可证获取颁发许可证模板。
DRMGetMetaData

从颁发许可证检索元数据。
DRMGetNameAndDescription

从颁发许可证中检索特定于语言的名称和说明。
DRMGetOwnerLicense

检索通过调用 DRMGetSignedIssuanceLicense 创建的所有者许可证。
DRMGetProcAddress

返回库中函数的地址。 它是 GetProcAddress 函数的安全版本。
DRMGetRevocationPoint

检索有关颁发许可证的吊销点的信息。
DRMGetRightExtendedInfo

检索附加到右侧的自定义名称/值对。
DRMGetRightInfo

获取有关以前创建的权利的信息。
DRMGetSecurityProvider

检索密码箱的路径。
DRMGetServiceLocation

检索可以执行各种权限管理服务(例如激活或获取许可证)的服务器 URL。
DRMGetSignedIssuanceLicense

联机或脱机获取已签名的颁发许可证,或生成以后可以签名的未签名的颁发许可证。
DRMGetSignedIssuanceLicenseEx

脱机获取已签名的颁发许可证。
DRMGetTime

从权限管理系统请求安全时间。
DRMGetUnboundLicenseAttribute

从基础 XrML 检索未绑定的许可证属性。
DRMGetUnboundLicenseAttributeCount

检索未绑定许可证中对象中某个属性的出现次数。
DRMGetUnboundLicenseObject

检索未绑定许可证中指定类型的对象。
DRMGetUnboundLicenseObjectCount

对许可证的指定分支中的对象的实例进行计数。
DRMGetUsagePolicy

获取一个使用策略,该策略要求或拒绝基于应用程序名称、版本或其他应用程序特征访问内容。
DRMGetUserInfo

获取有关用户的信息。
DRMGetUserRights

从颁发许可证中检索用户/权限对。
DRMGetUsers

从颁发许可证中检索特定用户。
DRMInitEnvironment

为所有权限管理调用创建安全环境。
DRMIsActivated

指示当前用户或计算机是否已激活。
DRMIsWindowProtected

指示窗口是否与受保护的环境相关联。
DRMLoadLibrary

根据凭据确定,将句柄加载到已批准的库。
DRMParseUnboundLicense

创建未绑定许可证的句柄,以允许应用程序导航其对象和属性。
DRMRegisterContent

通知 Active Directory Rights Management Services (AD RMS) 客户端正在或不再显示受 AD RMS 保护的文档。
DRMRegisterProtectedWindow

在受保护的环境中注册一个窗口。
DRMRegisterRevocationList

在客户端上注册权限吊销列表。
DRMRepair

通过删除以前为计算机或用户创建的证书来修复客户端计算机。
DRMSetApplicationSpecificData

允许颁发许可证存储任意名称/值对,供内容消耗型应用程序使用。
DRMSetGlobalOptions

将传输协议设置为指定值,并根据需要指定是否使用服务器密码箱。
DRMSetIntervalTime

指定在必须续订最终用户许可证之前可经过的颁发天数。
DRMSetMetaData

将特定于应用程序的元数据添加到颁发许可证。
DRMSetNameAndDescription

允许应用程序以多种人类) 语言指定许可证的名称和说明 (。
DRMSetRevocationPoint

设置刷新率和位置以获取吊销列表。
DRMSetUsagePolicy

设置一个使用策略,该策略根据应用程序名称、版本或其他环境特征要求或拒绝访问内容。
DRMVerify

不再受支持,并返回E_NOTIMPL。

结构

 
DRM_ACTSERV_INFO

DRM_ACTSERV_INFO结构存储有关激活服务器的信息。
DRM_CLIENT_VERSION_INFO

接收有关 Active Directory Rights Management Services (AD RMS) 客户端和层次结构(如生产或预生产)的信息。
DRM_LICENSE_ACQ_DATA

在非静态许可证获取期间保存许可证获取数据。
DRMBOUNDLICENSEPARAMS

由 DRMCreateBoundLicense 用于绑定到许可证。
DRMID

标识对象。