AcquireLicenseAsync Method (Guid)
Collapse the table of content
Expand the table of content

LicenseAcquirer.AcquireLicenseAsync Method (Guid)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Starts the license acquisition process.

Namespace:  System.Windows.Media
Assembly:  System.Windows (in System.Windows.dll)

public void AcquireLicenseAsync(
	Guid serviceId
)

Parameters

serviceId
Type: System.Guid
The service ID. This parameter is required only if you want to obtain a domain-bound license.

ExceptionCondition
InvalidOperationException

If this method is called when an existing license acquisition attempt is already in progress on that instance of the class.

InvalidOperationException

If this LicenseAcquirer was previously used for a MediaElement base license acquisition.

This overload of AcquireLicenseAsync generates a license challenge which only works with Windows Phone 8.

This overload of AcquireLicenseAsync creates an asynchronous license acquisition challenge in which no content key type or key ID set is sent in the challenge to the server. To provide the license server the requisite information to generate the needed license, it is recommended that service implementers use custom data, custom headers, or implement a custom protocol.

This overload of AcquireLicenseAsync is intended for use in scenarios where the root license does not have a traditional Key ID/Algorithm ID pair or the client does not have data about the root license ahead of time. It is expected that the license server logic would be able to determine the correct license to provide in the response based upon customer data.

The serviceId parameter is an optional parameter which may be used when acquiring a domain bound license.

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2017 Microsoft