Compartilhar via


WMRMKeys.GetCertificate

banner art

Previous Next

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

Previous Next

© 2007 Microsoft Corporation. All rights reserved.