ILicenseAcknowledgementHandler.HandleLicenseAcknowledgementAsync Method

Definition

Namespace:

Microsoft.Media.Drm

Assembly:

Microsoft.Media.Drm.RMCore.NETCore.dll

Service implemented method handling License Acknowledgement requests.

public System.Threading.Tasks.Task<Microsoft.Media.Drm.LicenseAcknowledgementResponse> HandleLicenseAcknowledgementAsync (Microsoft.Media.Drm.ILicenseAcknowledgementChallenge challenge);

abstract member HandleLicenseAcknowledgementAsync : Microsoft.Media.Drm.ILicenseAcknowledgementChallenge -> System.Threading.Tasks.Task<Microsoft.Media.Drm.LicenseAcknowledgementResponse>

Public Function HandleLicenseAcknowledgementAsync (challenge As ILicenseAcknowledgementChallenge) As Task(Of LicenseAcknowledgementResponse)

Parameters

challenge

ILicenseAcknowledgementChallenge

Parsed ILicenseAcknowledgementChallenge received from the client.

Returns

Task<LicenseAcknowledgementResponse>

The LicenseAcknowledgementResponse to be returned to the client.

Remarks

A license acknowledgement request is a report with the results of the storage of MediaLicenses on the client. In this method, the service would typically perform the following steps in order.

• Check the SignatureVerified property to ensure that the acknowledgement was not tampered with.
• Verify that the TransactionId matches a previously-recorded ID.
• Retrieve the results and execute tasks, depending on the results of the acknowledgment requests.
• Return the response to the client.

Typically, the only exception the service might throw from this method is ServiceSpecificException. Note that the results of storing an obsolete SimpleNonPersistentLicense are not reported to the server. Note that most PlayReady clients do not implement license acknowledgement. See Rental.cs for a sample implementation of this method.