PlayReadyContentHeader Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
PlayReadyContentHeader(Byte[]) |
Initialise une nouvelle instance de la classe PlayReadyContentHeader . |
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid) |
Initialise une nouvelle instance de la classe PlayReadyContentHeader . |
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Initialise une nouvelle instance de la classe PlayReadyContentHeader . |
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Initialise une nouvelle instance de la classe PlayReadyContentHeader. |
PlayReadyContentHeader(Byte[])
Initialise une nouvelle instance de la classe PlayReadyContentHeader .
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())
Paramètres
- headerBytes
-
Byte[]
byte[]
Octets de données brutes représentant un en-tête de contenu PlayReady.
S’applique à
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)
Initialise une nouvelle instance de la classe PlayReadyContentHeader .
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)
Paramètres
- headerBytes
-
Byte[]
byte[]
Octets de données brutes représentant un en-tête WMDRM hérité.
URL du service Web d’acquisition de licence silencieux (sans interaction utilisateur).
URL d’une page Web d’acquisition de licence non silencieuse.
- customAttributes
-
String
Platform::String
winrt::hstring
Contient des données personnalisées utilisées par le fournisseur de contenu. L’auteur du contenu peut ajouter du code XML arbitraire à l’intérieur de cet élément. Le code Microsoft n’agit pas sur les données contenues dans cet élément.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Identificateur de service pour le service de domaine.
Remarques
Ce constructeur doit être utilisé pour convertir un en-tête WMDRM hérité en en-tête PlayReady.
Le paramètre domainServiceId est sensible à l’endianness de la plateforme sous-jacente. Testez soigneusement votre application sur toutes les plateformes que vous envisagez de prendre en charge pour vous assurer que l’endianness correct est utilisé sur chaque plateforme.
S’applique à
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Initialise une nouvelle instance de la classe PlayReadyContentHeader .
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)
Paramètres
- contentKeyId
-
Guid
Platform::Guid
winrt::guid
Identificateur de la clé de chiffrement de contenu.
- contentKeyIdString
-
String
Platform::String
winrt::hstring
Représentation sous forme de chaîne de la clé de contenu. Si le paramètre contentKeyId est spécifié, ce paramètre est ignoré.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Type d’algorithme de chiffrement utilisé pour chiffrer le contenu.
URL du service Web d’acquisition de licence silencieux (sans interaction utilisateur).
URL d’une page Web d’acquisition de licence non silencieuse.
- customAttributes
-
String
Platform::String
winrt::hstring
Contient des données personnalisées utilisées par le fournisseur de contenu. L’auteur du contenu peut ajouter du code XML arbitraire à l’intérieur de cet élément. Le code Microsoft n’agit pas sur les données contenues dans cet élément.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Identificateur de service pour le service de domaine.
Remarques
Les paramètres contentKeyId et domainServiceId sont sensibles à l’endianness de la plateforme sous-jacente. Testez soigneusement votre application sur toutes les plateformes que vous envisagez de prendre en charge pour vous assurer que l’endianness correct est utilisé sur chaque plateforme.
À compter de Windows 10, version 1709, vous pouvez spécifier PlayReadyEncryptionAlgorithm.Aes128Cbc, pour le chiffrement AES128CBC, ou PlayReadyEncryptionAlgorithm.Unspecified, pour permettre au serveur principal de déterminer le type de chiffrement, comme valeur du paramètre contentEncryptionAlgorithm. Dans les versions précédentes de Windows 10, la spécification de l’une de ces valeurs entraîne la levée d’une exception. Pour cette raison, vous devez vérifier la présence de la valeur d’énumération en appelant ApiInformationIsApiContractPresent et en spécifiant la version de contrat principal 5 avant d’utiliser les nouvelles valeurs d’énumération dans l’appel du constructeur.
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
}
S’applique à
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Initialise une nouvelle instance de la classe PlayReadyContentHeader.
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)
Paramètres
- dwFlags
-
UInt32
unsigned int
uint32_t
Réservé. Définit la valeur 0.
- contentKeyIds
-
Guid[]
Platform::Guid[]
winrt::guid[]
Identificateurs des clés de chiffrement de contenu.
- contentKeyIdStrings
-
String[]
Platform::String[]
winrt::hstring[]
Représentations sous forme de chaîne des clés de contenu. Chaque chaîne doit être une valeur codée en base 64 de 16 octets.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Type d’algorithme de chiffrement utilisé pour chiffrer le contenu.
URL du service Web d’acquisition de licence silencieux (sans interaction utilisateur).
URL d’une page Web d’acquisition de licence non silencieuse.
- customAttributes
-
String
Platform::String
winrt::hstring
Contient des données personnalisées utilisées par le fournisseur de contenu. L’auteur du contenu peut ajouter du code XML arbitraire à l’intérieur de cet élément. Le code Microsoft n’agit pas sur les données contenues dans cet élément.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Identificateur de service pour le service de domaine.
Remarques
Les paramètres contentKeyIds et domainServiceId sont sensibles à l’endianness de la plateforme sous-jacente. Testez soigneusement votre application sur toutes les plateformes que vous envisagez de prendre en charge pour vous assurer que l’endianness correct est utilisé sur chaque plateforme.
À compter de Windows 10, version 1709, vous pouvez spécifier PlayReadyEncryptionAlgorithm.Aes128Cbc, pour le chiffrement AES128CBC, ou PlayReadyEncryptionAlgorithm.Unspecified, pour permettre au serveur principal de déterminer le type de chiffrement, comme valeur du paramètre contentEncryptionAlgorithm. Dans les versions précédentes de Windows 10, la spécification de l’une de ces valeurs entraîne la levée d’une exception. Pour cette raison, vous devez vérifier la présence de la valeur d’énumération en appelant ApiInformationIsApiContractPresent et en spécifiant la version de contrat principal 5 avant d’utiliser les nouvelles valeurs d’énumération dans l’appel du constructeur.
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
}