PlayReadyContentHeader コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
PlayReadyContentHeader(Byte[]) |
PlayReadyContentHeader クラスの新しいインスタンスを初期化します。 |
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid) |
PlayReadyContentHeader クラスの新しいインスタンスを初期化します。 |
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
PlayReadyContentHeader クラスの新しいインスタンスを初期化します。 |
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
PlayReadyContentHeader クラスの新しいインスタンスを初期化します。 |
PlayReadyContentHeader(Byte[])
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())
パラメーター
- headerBytes
-
Byte[]
byte[]
PlayReady コンテンツ ヘッダーを表す生データ バイト。
適用対象
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)
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)
パラメーター
- headerBytes
-
Byte[]
byte[]
レガシ WMDRM ヘッダーを表す生データ バイト。
- customAttributes
-
String
Platform::String
winrt::hstring
コンテンツ プロバイダーによって使用されるカスタム データが含まれます。 コンテンツ作成者は、この要素内に任意の XML を追加できます。 Microsoft コードは、この要素内に含まれるデータに対して動作しません。
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
ドメイン サービスのサービス識別子。
注釈
このコンストラクターは、従来の WMDRM ヘッダーを PlayReady ヘッダーに変換するために使用する必要があります。
domainServiceId パラメーターは、基になるプラットフォームのエンディアンに依存します。 サポートするすべてのプラットフォームでアプリを慎重にテストし、各プラットフォームで正しいエンディアンが使用されていることを確認します。
適用対象
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
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)
パラメーター
- contentKeyId
-
Guid
Platform::Guid
winrt::guid
コンテンツ暗号化キーの識別子。
- contentKeyIdString
-
String
Platform::String
winrt::hstring
コンテンツ キーの文字列形式。 contentKeyId パラメーターが指定されている場合、このパラメーターは無視されます。
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
コンテンツの暗号化に使用される暗号化アルゴリズムの種類。
- customAttributes
-
String
Platform::String
winrt::hstring
コンテンツ プロバイダーによって使用されるカスタム データが含まれます。 コンテンツ作成者は、この要素内に任意の XML を追加できます。 Microsoft コードは、この要素内に含まれるデータに対して動作しません。
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
ドメイン サービスのサービス識別子。
注釈
contentKeyId パラメーターと domainServiceId パラメーターは、基になるプラットフォームのエンディアンに依存します。 サポートするすべてのプラットフォームでアプリを慎重にテストし、各プラットフォームで正しいエンディアンが使用されていることを確認します。
バージョン 1709 Windows 10以降、AES128CBC 暗号化に PlayReadyEncryptionAlgorithm.Aes128Cbc を指定するか、PlayReadyEncryptionAlgorithm.Unspecified を指定して、サーバー バックエンドが contentEncryptionAlgorithm パラメーターの値として暗号化の種類を決定できるようにします。 以前のバージョンのWindows 10では、これらの値のいずれかを指定すると、例外がスローされます。 このため、コンストラクター呼び出しで新しい列挙型値を使用する前に 、ApiInformationIsApiContractPresent を呼び出し、メジャー コントラクト バージョン 5 を指定して列挙値の存在を確認する必要があります。
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
}
適用対象
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
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)
パラメーター
- dwFlags
-
UInt32
unsigned int
uint32_t
予約済み。 0 に設定されます。
- contentKeyIds
-
Guid[]
Platform::Guid[]
winrt::guid[]
コンテンツ暗号化キーの識別子。
- contentKeyIdStrings
-
String[]
Platform::String[]
winrt::hstring[]
コンテンツ キーの文字列表現。 各文字列は、Base-64 でエンコードされた 16 バイト値である必要があります。
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
コンテンツの暗号化に使用される暗号化アルゴリズムの種類。
- customAttributes
-
String
Platform::String
winrt::hstring
コンテンツ プロバイダーによって使用されるカスタム データが含まれます。 コンテンツ作成者は、この要素内に任意の XML を追加できます。 Microsoft コードは、この要素内に含まれるデータに対して動作しません。
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
ドメイン サービスのサービス識別子。
注釈
contentKeyIds パラメーターと domainServiceId パラメーターは、基になるプラットフォームのエンディアンに依存します。 サポートするすべてのプラットフォームでアプリを慎重にテストし、各プラットフォームで正しいエンディアンが使用されていることを確認します。
バージョン 1709 Windows 10以降、AES128CBC 暗号化に PlayReadyEncryptionAlgorithm.Aes128Cbc を指定するか、PlayReadyEncryptionAlgorithm.Unspecified を指定して、サーバー バックエンドが contentEncryptionAlgorithm パラメーターの値として暗号化の種類を決定できるようにします。 以前のバージョンのWindows 10では、これらの値のいずれかを指定すると、例外がスローされます。 このため、コンストラクター呼び出しで新しい列挙型値を使用する前に 、ApiInformationIsApiContractPresent を呼び出し、メジャー コントラクト バージョン 5 を指定して列挙値の存在を確認する必要があります。
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
}