.gif) |
WMRMKeys.GetCertificate
The GetCertificate method returns certificates used to sign the header.
Syntax
WMRMKeys.GetCertificate(bstrCertType)
Parameters
bstrCertType
[in] String containing the certificate type (see Remarks).
Return Values
This method returns a String containing the requested certificate from the registry. If it fails, it returns a number in the error object.
To specify a certificate type, pass one of the following values into bstrCertType.
| Return code | Returned certificate |
| LSHeaderSigningCert | The certificate used to verify the entire header. This value corresponds to cert0. |
| LSLicenseSigningCert | The licensor certificate used by the client to verify the license. This value corresponds to cert1. |
| LSRootCert | The Microsoft DRM License Server Root certificate. This value corresponds to cert2. |
Remarks
This method allows individual certificates in the header certificate chain to be retrieved. To assemble a complete certificate chain to verify a header, you need all three certificates. The header signing certificate is returned by the GenerateSigningKeysEx call that originally generated the header keys, but it can be obtained by calling this function as well. The licensor certificate and the license server root certificate are obtained in two separate calls to this function. Note that GenerateSigningKeysEx must be called at least once to generate and store the header signing certificate.
This method is required only if you are creating a DRM profile for a user who wants to protect content using Windows Media Encoder. Extended header signing is performed automatically when generating headers using the Windows Media Rights Manager SDK.
Requirements
Version: Windows Media Rights Manager 9 Series SDK or later
Reference: wmrmobjs 1.0 Type Library
Library: wmrmobjs.dll
Platform: Windows Server 2003
See Also