Skip to content

Latest commit

 

History

History
122 lines (80 loc) · 4.91 KB

nf-msdrm-drmcreatelicensestoragesession.md

File metadata and controls

122 lines (80 loc) · 4.91 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist req.product ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:msdrm.DRMCreateLicenseStorageSession
DRMCreateLicenseStorageSession function (msdrm.h)
Creates a license storage session, which is needed to acquire or manipulate a license.
DRMCreateLicenseStorageSession
DRMCreateLicenseStorageSession function [Active Directory Rights Management Services SDK 1.0]
msdrm/DRMCreateLicenseStorageSession
rm.drmcreatelicensestoragesession
rm\drmcreatelicensestoragesession.htm
rm
6561b6df-373b-4bd3-9196-09ef945f8042
12/05/2018
DRMCreateLicenseStorageSession, DRMCreateLicenseStorageSession function [Active Directory Rights Management Services SDK 1.0], msdrm/DRMCreateLicenseStorageSession, rm.drmcreatelicensestoragesession
msdrm.h
Windows
Msdrm.lib
Msdrm.dll
Windows
Rights Management Services client 1.0 SP2 or later
19H1
DRMCreateLicenseStorageSession
msdrm/DRMCreateLicenseStorageSession
c++
APIRef
kbSyntax
DllExport
Msdrm.dll
DRMCreateLicenseStorageSession

DRMCreateLicenseStorageSession function

-description

[The AD RMS SDK leveraging functionality exposed by

the client in Msdrm.dll is available for use in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, and Windows 8. It may be altered or

unavailable in subsequent versions. Instead, use Active Directory Rights Management Services SDK 2.1,

which leverages functionality exposed by the client in Msipc.dll.]

The DRMCreateLicenseStorageSession function creates a license storage session, which is needed to acquire or manipulate a license.

-parameters

-param hEnv [in]

A handle to the AD RMS environment. This handle is obtained by using the DRMInitEnvironment function.

-param hDefaultLibrary [in]

A handle to the default library. This handle is obtained by using the DRMInitEnvironment function.

-param hClient [in]

A handle to a client session. This handle is obtained by using the DRMCreateClientSession function.

-param uFlags [in]

This parameter is reserved and must be set to zero.

-param wszIssuanceLicense [in]

A pointer to a null-terminated Unicode string that contains a signed issuance license. The created license storage session is associated with this issuance license.

-param phLicenseStorage [out]

A pointer to a handle that receives the license storage session handle. This handle must be passed to the DRMCloseSession function when the license storage session is no longer needed.

-returns

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

-remarks

A license storage session is used for acquiring, deleting, and enumerating licenses, among other uses. To actually bind to a license and exercise its rights, an application must use DRMCreateBoundLicense.

The environment handle and default library handle are created by using DRMInitEnvironment.

The handle returned in the phLicenseStorage parameter must be passed to the DRMCloseSession function when the license storage session is no longer needed.

-see-also

AD RMS Functions

DRMCloseHandle

DRMCreateClientSession

DRMInitEnvironment

Decryption_GetBoundLicense.cpp