PlayReadyContentHeader Konstruktoren

Referenz

Definition

Namespace:: Windows.Media.Protection.PlayReady

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

PlayReadyContentHeader(Byte[])	Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)	Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)	Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)	Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse.

PlayReadyContentHeader(Byte[])

Bearbeiten

Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .

public:
 PlayReadyContentHeader(Platform::Array <byte> ^ headerBytes);

 PlayReadyContentHeader(winrt::array_view <byte> const& headerBytes);

public PlayReadyContentHeader(byte[] headerBytes);

function PlayReadyContentHeader(headerBytes)

Public Sub New (headerBytes As Byte())

Parameter

headerBytes: Byte[]

byte[]

Rohdatenbytes, die einen PlayReady-Inhaltsheader darstellen.

Gilt für:

PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)

Bearbeiten

Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .

public:
 PlayReadyContentHeader(Platform::Array <byte> ^ headerBytes, Uri ^ licenseAcquisitionUrl, Uri ^ licenseAcquisitionUserInterfaceUrl, Platform::String ^ customAttributes, Platform::Guid domainServiceId);

 PlayReadyContentHeader(winrt::array_view <byte> const& headerBytes, Uri const& licenseAcquisitionUrl, Uri const& licenseAcquisitionUserInterfaceUrl, winrt::hstring const& customAttributes, winrt::guid const& domainServiceId);

public PlayReadyContentHeader(byte[] headerBytes, System.Uri licenseAcquisitionUrl, System.Uri licenseAcquisitionUserInterfaceUrl, string customAttributes, Guid domainServiceId);

function PlayReadyContentHeader(headerBytes, licenseAcquisitionUrl, licenseAcquisitionUserInterfaceUrl, customAttributes, domainServiceId)

Public Sub New (headerBytes As Byte(), licenseAcquisitionUrl As Uri, licenseAcquisitionUserInterfaceUrl As Uri, customAttributes As String, domainServiceId As Guid)

Parameter

headerBytes: Byte[]

byte[]

Rohdatenbytes, die einen älteren WMDRM-Header darstellen.

licenseAcquisitionUrl: Uri Uri

Die URL für den unbeaufsichtigten Lizenzerwerbswebdienst (keine Benutzerinteraktion).

licenseAcquisitionUserInterfaceUrl: Uri Uri

Die URL für eine Webseite zum Erwerb einer nicht unbeaufsichtigten Lizenz.

customAttributes: String
Platform::String

winrt::hstring

Enthält benutzerdefinierte Daten, die vom Inhaltsanbieter verwendet werden. Der Inhaltsautor kann diesem Element beliebige XML-Dateien hinzufügen. Microsoft-Code reagiert nicht auf Daten, die in diesem Element enthalten sind.

domainServiceId: Guid
Platform::Guid

winrt::guid

Dienstbezeichner für den Domänendienst.

Hinweise

Dieser Konstruktor sollte verwendet werden, um einen Legacy-WMDRM-Header in einen PlayReady-Header zu konvertieren.

Der domainServiceId-Parameter berücksichtigt die Endianität der zugrunde liegenden Plattform. Testen Sie Ihre App sorgfältig auf allen Plattformen, die Sie unterstützen möchten, um sicherzustellen, dass auf jeder Plattform die richtige Endianität verwendet wird.

Gilt für:

PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

Bearbeiten

Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .

public:
 PlayReadyContentHeader(Platform::Guid contentKeyId, Platform::String ^ contentKeyIdString, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, Uri ^ licenseAcquisitionUrl, Uri ^ licenseAcquisitionUserInterfaceUrl, Platform::String ^ customAttributes, Platform::Guid domainServiceId);

 PlayReadyContentHeader(winrt::guid const& contentKeyId, winrt::hstring const& contentKeyIdString, PlayReadyEncryptionAlgorithm const& contentEncryptionAlgorithm, Uri const& licenseAcquisitionUrl, Uri const& licenseAcquisitionUserInterfaceUrl, winrt::hstring const& customAttributes, winrt::guid const& domainServiceId);

public PlayReadyContentHeader(Guid contentKeyId, string contentKeyIdString, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, System.Uri licenseAcquisitionUrl, System.Uri licenseAcquisitionUserInterfaceUrl, string customAttributes, Guid domainServiceId);

function PlayReadyContentHeader(contentKeyId, contentKeyIdString, contentEncryptionAlgorithm, licenseAcquisitionUrl, licenseAcquisitionUserInterfaceUrl, customAttributes, domainServiceId)

Public Sub New (contentKeyId As Guid, contentKeyIdString As String, contentEncryptionAlgorithm As PlayReadyEncryptionAlgorithm, licenseAcquisitionUrl As Uri, licenseAcquisitionUserInterfaceUrl As Uri, customAttributes As String, domainServiceId As Guid)

Parameter

contentKeyId: Guid
Platform::Guid

winrt::guid

Bezeichner des Inhaltsverschlüsselungsschlüssels.

contentKeyIdString: String
Platform::String

winrt::hstring

Zeichenfolgendarstellung des Inhaltsschlüssels. Wenn der parameter contentKeyId angegeben wird, wird dieser Parameter ignoriert.

contentEncryptionAlgorithm: PlayReadyEncryptionAlgorithm

Verschlüsselungsalgorithmustyp, der zum Verschlüsseln des Inhalts verwendet wird.

licenseAcquisitionUrl: Uri Uri

Die URL für den unbeaufsichtigten Lizenzerwerbswebdienst (keine Benutzerinteraktion).

licenseAcquisitionUserInterfaceUrl: Uri Uri

Die URL für eine Webseite zum Erwerb einer nicht unbeaufsichtigten Lizenz.

customAttributes: String
Platform::String

winrt::hstring

domainServiceId: Guid
Platform::Guid

winrt::guid

Dienstbezeichner für den Domänendienst.

Hinweise

Die Parameter contentKeyId und domainServiceId sind empfindlich auf die Endianität der zugrunde liegenden Plattform. Testen Sie Ihre App sorgfältig auf allen Plattformen, die Sie unterstützen möchten, um sicherzustellen, dass auf jeder Plattform die richtige Endianität verwendet wird.

Ab Windows 10 Version 1709 können Sie PlayReadyEncryptionAlgorithm.Aes128Cbc für die AES128CBC-Verschlüsselung oder PlayReadyEncryptionAlgorithm.Unspecified angeben, damit das Server-Back-End den Verschlüsselungstyp als Wert für den Parameter contentEncryptionAlgorithm bestimmen kann. Wenn Sie in früheren Versionen von Windows 10 einen dieser Werte angeben, wird eine Ausnahme ausgelöst. Aus diesem Grund sollten Sie überprüfen, ob der Enumerationswert vorhanden ist, indem Sie ApiInformationIsApiContractPresent aufrufen und Hauptvertragsversion 5 angeben, bevor Sie die neuen Enumerationswerte im Konstruktoraufruf verwenden.

bool supportsAes128CbcAndUnspecified = ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 5);

if (supportsAes128CbcAndUnspecified)
{
    // Guid and URL below are known by app, obtaining them is out of scope
    PlayReadyContentHeader header = new PlayReadyContentHeader(
        new Guid("{6591a70e-06fc-4d1f-862a-80bb569f07da}"),
        null,
        PlayReadyEncryptionAlgorithm.Unspecified,
        new Uri("http://www.contoso.com/rightsmanager.aspx"),
        null,
        null,
        new Guid("{215304E7-9263-446A-B150-0754D5E18973}"));

    var request = PlayReadyContentResolver.ServiceRequest(header);
    await request.BeginServiceRequest();
}
else
{
    // Application chooses behavior, for example, picks different content
    // or tells user that their system doesn’t support the selected content
}

Gilt für:

PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

Bearbeiten

Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse.

public:
 PlayReadyContentHeader(unsigned int dwFlags, Platform::Array <Platform::Guid> ^ contentKeyIds, Platform::Array <Platform::String ^> ^ contentKeyIdStrings, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, Uri ^ licenseAcquisitionUrl, Uri ^ licenseAcquisitionUserInterfaceUrl, Platform::String ^ customAttributes, Platform::Guid domainServiceId);

 PlayReadyContentHeader(uint32_t const& dwFlags, winrt::array_view <winrt::guid> const& contentKeyIds, winrt::array_view <winrt::hstring const&> const& contentKeyIdStrings, PlayReadyEncryptionAlgorithm const& contentEncryptionAlgorithm, Uri const& licenseAcquisitionUrl, Uri const& licenseAcquisitionUserInterfaceUrl, winrt::hstring const& customAttributes, winrt::guid const& domainServiceId);

public PlayReadyContentHeader(uint dwFlags, Guid[] contentKeyIds, string[] contentKeyIdStrings, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, System.Uri licenseAcquisitionUrl, System.Uri licenseAcquisitionUserInterfaceUrl, string customAttributes, Guid domainServiceId);

function PlayReadyContentHeader(dwFlags, contentKeyIds, contentKeyIdStrings, contentEncryptionAlgorithm, licenseAcquisitionUrl, licenseAcquisitionUserInterfaceUrl, customAttributes, domainServiceId)

Public Sub New (dwFlags As UInteger, contentKeyIds As Guid(), contentKeyIdStrings As String(), contentEncryptionAlgorithm As PlayReadyEncryptionAlgorithm, licenseAcquisitionUrl As Uri, licenseAcquisitionUserInterfaceUrl As Uri, customAttributes As String, domainServiceId As Guid)

Parameter

dwFlags: UInt32
unsigned int

uint32_t

Reserviert. Auf 0 festlegen.

contentKeyIds: Guid[]

Platform::Guid[]

winrt::guid[]

Bezeichner der Inhaltsverschlüsselungsschlüssel.

contentKeyIdStrings: String[]

Platform::String[]

winrt::hstring[]

Zeichenfolgendarstellungen der Inhaltsschlüssel. Jede Zeichenfolge muss ein Base64-codierter 16-Byte-Wert sein.

contentEncryptionAlgorithm: PlayReadyEncryptionAlgorithm

Verschlüsselungsalgorithmustyp, der zum Verschlüsseln des Inhalts verwendet wird.

licenseAcquisitionUrl: Uri Uri

Die URL für den unbeaufsichtigten Lizenzerwerbswebdienst (keine Benutzerinteraktion).

licenseAcquisitionUserInterfaceUrl: Uri Uri

Die URL für eine Webseite zum Erwerb einer nicht unbeaufsichtigten Lizenz.

customAttributes: String
Platform::String

winrt::hstring

domainServiceId: Guid
Platform::Guid

winrt::guid

Dienstbezeichner für den Domänendienst.

Hinweise

Die Parameter contentKeyIds und domainServiceId sind empfindlich auf die Endianität der zugrunde liegenden Plattform. Testen Sie Ihre App sorgfältig auf allen Plattformen, die Sie unterstützen möchten, um sicherzustellen, dass auf jeder Plattform die richtige Endianität verwendet wird.

bool supportsAes128CbcAndUnspecified = ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 5);

if (supportsAes128CbcAndUnspecified)
{
    // Guid and URL below are known by app, obtaining them is out of scope
    PlayReadyContentHeader header = new PlayReadyContentHeader(
        new Guid("{6591a70e-06fc-4d1f-862a-80bb569f07da}"),
        null,
        PlayReadyEncryptionAlgorithm.Unspecified,
        new Uri("http://www.contoso.com/rightsmanager.aspx"),
        null,
        null,
        new Guid("{215304E7-9263-446A-B150-0754D5E18973}"));

    var request = PlayReadyContentResolver.ServiceRequest(header);
    await request.BeginServiceRequest();
}
else
{
    // Application chooses behavior, for example, picks different content
    // or tells user that their system doesn’t support the selected content
}

Gilt für:

Freigeben über

PlayReadyContentHeader Konstruktoren

Definition

Überlädt

PlayReadyContentHeader(Byte[])

Parameter

Gilt für:

PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)

Parameter

Hinweise

Gilt für:

PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

Parameter

Hinweise

Gilt für:

PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

Parameter

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen