Active Directory Rights Management 服務 SDK

Active Directory Rights Management Services SDK 技術概觀。

若要開發 Active Directory Rights Management Services SDK，您需要下列標頭：

• msdrm.h
• msdrmdefs.h

如需這項技術的程序設計指引，請參閱：

• Active Directory Rights Management 服務 SDK

列舉項目

DRM_DISTRIBUTION_POINT_INFO 指定呼叫 DRMGetIssuanceLicenseInfo 時要擷取資訊的發佈點類型。
DRM_STATUS_MSG 由自訂回呼函式用來指定呼叫回呼函式的原因。
DRM_USAGEPOLICY_TYPE 與 DRMGetUsagePolicy 和 DRMSetUsagePolicy 函式搭配使用，以指定使用原則類型。
DRMATTESTTYPE DRMATTESTTYPE 列舉會指定要為資料 Blob 建立的簽章類型。
DRMENCODINGTYPE DRMENCODINGTYPE 列舉會識別授權中使用的可能編碼類型。
DRMGLOBALOPTIONS 定義值，以指定傳輸通訊協定使用的通訊協定，以及是否使用伺服器加密箱。 此列舉是由 DRMSetGlobalOptions 函式使用。
DRMSECURITYPROVIDERTYPE DRMSECURITYPROVIDERTYPE 列舉會指定所使用的安全 DRM 環境類型。
DRMSPEC類型 DRMSPECTYPE 列舉會指出所使用的安全性或連結庫提供者類型。
DRMTIMETYPE DRMTIMETYPE 列舉會指定時間類型。

Functions

DRMAcquire諮詢 擷取已提交授權所需的撤銷清單。
DRMAcquireIssuanceLicenseTemplate 非同步地從伺服器擷取發行授權範本。
DRMAcquire授權 嘗試以非同步方式取得使用者授權或用戶端授權人憑證。
DRMActivate 取得電腦的加密箱和電腦憑證，或使用者的權限帳戶憑證。
DRMAdd授權 將一般使用者授權新增至暫時或永久授權存放區。
DRMAddRightWithUser 將權限指派給發行授權中的使用者。
DRMA測試 不再支援 DRMAttest 函式，並傳回E_NOTIMPL。
DRM回呼 AD RMS SDK 中包含的某些函式會使用您必須實作的回呼函式，為您的應用程式提供狀態資訊和授權。 回呼語法如下所示。
DRMCheck安全性 傳回正在執行的任何安全檢查層級的S_OK。
DRMClearAllRights 從現有的發行授權中移除所有權利。
DRMCloseEnvironmentHandle 關閉環境控點。
DRMCloseHandle 關閉使用 DRMCreate* 函式建立的物件和使用 DRMLoadLibrary 載入的程式庫的控制碼。
DRMClosePubHandle 關閉先前建立的 DRMPUBHANDLE。
DRMCloseQueryHandle 關閉未繫結授權物件的控點。
DRMCloseSession 關閉用戶端工作階段或授權儲存體工作階段。
DRMConstructCertificateChain 從任意數目的憑證建置憑證鏈結。
DRMCreateBoundLicense 允許應用程式檢查或行使本機儲存授權的權利。
DRMCreateClientSession 建立用戶端工作階段，以裝載授權儲存體工作階段，並用於啟用和其他函式呼叫。
DRMCreateEnablingBitsDecryptor 建立用來解密內容資料的解密物件。
DRMCreateEnablingBitsEncryptor 建立用來加密內容資料的 AD RMS 加密物件。
DRMCreateEnablingPrincipal 建立繫結至授權所需的啟用主體。
DRMCreateIssuanceLicense 從頭開始、從範本或已簽署的發行授權建立發行授權。
DRMCreateLicenseStorageSession 建立授權儲存會話，這是取得或操作授權所需的。
DRMCreateRight 建立 XrML 權限，以定義授與使用者或群組的權限。
DRMCreateUser 建立將授與權限的使用者。
DRMDecode 解碼使用通用演算法編碼的字串，例如 base64。
DRMDeconstructCertificateChain 從憑證鏈擷取指定的憑證。
DRMDecrypt 解密加密內容。
DRMDelete授權 刪除授權、用戶端授權人憑證、撤銷清單或發行授權範本。
DRMDuplicateEnvironmentHandle 建立環境控點的複本。
DRMDuplicateHandle 建立 DRMHANDLE 的複本。
DRMDuplicatePubHandle 建立 DRMPUBHANDLE 的複本。
DRMDuplicateSession 複製用戶端或授權儲存體工作階段。
DRM編碼 使用公用編碼方法（例如 base64）對資料進行編碼。
DRMEncrypt 加密數據。
DRMEnumerate授權 列舉有效的授權、電腦憑證或權限帳戶憑證、目前使用者的撤銷清單或發行授權範本。
DRMGetApplicationSpecificData 擷取任意應用程式特定資訊的名稱值配對。
DRMGetBoundLicense屬性 從授權 XrML 擷取繫結的授權屬性。
DRMGetBoundLicenseAttributeCount 擷取授權中屬性的出現次數。
DRMGetBoundLicenseObject 從繫結授權傳回物件。
DRMGetBoundLicenseObjectCount 擷取授權指定分支內物件的出現次數。
DRMGetCertificateChainCount 擷取憑證鏈結中的憑證數目。
DRMGetClient版本 傳回 Active Directory Rights Management Services 用戶端軟體的版本號碼，以及階層是用於生產還是生產前用途。
DRMGet環境資訊 傳回安全環境的相關資訊。
DRMGet資訊 擷取有關加密或解密物件的資訊。
DRMGet間隔時間 擷取從發行到最終使用者授權必須續約之前可以經過的天數。
DRMGetIssuanceLicenseInfo 從發行授權擷取各種資訊。
DRMGetIssuanceLicenseTemplate 從現有的發行授權取得發行授權範本。
DRMGet中繼資料 從發行授權擷取中繼資料。
DRMGetNameAndDescription 從發行授權擷取語言特定名稱和描述。
DRMGetOwner授權 擷取呼叫 DRMGetSignedIssuanceLicense 所建立的擁有者授權。
DRMGetProc位址 傳回函式庫中函式的位址。 這是 GetProcAddress 函式的安全版本。
DRMGet撤銷點 擷取發行授權撤銷點的相關資訊。
DRMGetRightExtendedInfo 擷取附加至右側的自訂名稱值組。
DRMGetRightInfo 取得先前建立的權限的相關資訊。
DRMGetSecurityProvider 擷取加密箱的路徑。
DRMGetService位置 擷取可執行各種權限管理服務 （例如啟用或授權取得） 的伺服器 URL。
DRMGetSignedIssuanceLicense 線上或離線取得已簽署的發行授權，或產生稍後可簽署的未簽署發行授權。
DRMGetSignedIssuanceLicenseEx 離線取得已簽署的發行許可證。
DRMGetTime 向權限管理系統要求安全時間。
DRMGetUnboundLicense屬性 從基礎 XrML 擷取未繫結的授權屬性。
DRMGetUnboundLicenseAttributeCount 擷取未繫結授權中物件內屬性的出現次數。
DRMGetUnboundLicenseObject 擷取未繫結授權中指定類型的物件。
DRMGetUnboundLicenseObjectCount 計算授權指定分支內物件的執行個體。
DRMGetUsagePolicy 取得使用原則，根據應用程式名稱、版本或其他應用程式特性，要求或拒絕存取內容。
DRMGet使用者資訊 取得使用者的相關資訊。
DRMGet使用者權限 從發行授權擷取使用者/權限配對。
DRMGet使用者 從發行授權擷取特定使用者。
DRMInit環境 為所有權限管理呼叫建立安全的環境。
DRMIsActivated 指出目前使用者或電腦是否已啟用。
DRMIsWindowProtected 指出視窗是否與受保護的環境相關聯。
DRMLoad程式庫 將控制碼載入至已核准的程式庫，由認證決定。
DRMParseUnbound授權 建立未繫結授權的控制碼，以允許應用程式導覽其物件和屬性。
DRMRegister內容 通知 Active Directory Rights Management Services （AD RMS） 用戶端正在或不再顯示受 AD RMS 保護的文件。
DRMRegisterProtected視窗 在受保護的環境中註冊視窗。
DRMRegister撤銷清單 在用戶端上註冊權限撤銷清單。
DRM雷普爾 刪除先前為電腦或使用者建立的憑證，以修復用戶端電腦。
DRMSetApplicationSpecificData 允許發行授權儲存任意名稱值組，以供內容取用應用程式使用。
DRMSetGlobal選項 將傳輸通訊協定設定為指定的值，並選擇性地指定是否使用伺服器加密箱。
DRMSet間隔時間 指定從發行開始，在必須更新使用者授權之前可以經過的天數。
DRMSetMetaData 將應用程式特定的中繼資料新增至發行授權。
DRMSetNameAndDescription 允許應用程式以多種 （人類） 語言指定授權的名稱和描述。
DRMSetRevocationPoint 設定重新整理頻率和位置以取得撤銷清單。
DRMSetUsagePolicy 設定使用原則，根據應用程式名稱、版本或其他環境特性，要求或拒絕存取內容。
DRM認證 不再支援並返回E_NOTIMPL。

結構體系

DRM_ACTSERV_INFO DRM_ACTSERV_INFO結構會儲存啟動伺服器的相關資訊。
DRM_CLIENT_VERSION_INFO 接收 Active Directory Rights Management Services （AD RMS） 用戶端版本和階層的相關資訊，例如生產或生產前。
DRM_LICENSE_ACQ_DATA 在非無訊息授權取得期間保留授權取得資料。
DRMBOUNDLICENSE參數 DRMCreateBoundLicense 用來系結至授權。
DRMID的 識別物件。