Partager via


Méthode IWMDRMNetTransmitter::GetRootLicenseResponse

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode GetRootLicenseResponse génère un message de réponse de licence racine.

Syntaxe

HRESULT GetRootLicenseResponse(
  [in]  BSTR  bstrKID,
  [out] BYTE  **ppbLicenseResponse,
  [out] DWORD *pcbLicenseResponse
);

Paramètres

bstrKID [in]

Identificateur de clé encodé en base64 à utiliser pour la nouvelle licence racine. L’identificateur de clé doit être une valeur GUID générée de manière aléatoire.

ppbLicenseResponse [out]

Adresse d’une variable qui reçoit l’adresse de la réponse de licence générée. Une fois ces données terminées, vous devez libérer la mémoire en appelant CoTaskMemFree.

pcbLicenseResponse [out]

Adresse d’une variable qui reçoit la taille de la réponse de licence, en octets.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
NS_E_DRM_RIV_TOO_SMALL
Une liste de révocation de contenu mise à jour est nécessaire.
S_OK
S_OK

Notes

La licence racine générée est créée à l’aide des informations des données de contestation de licence, qui sont traitées pour l’interface en appelant SetLicenseChallenge.

La licence racine est utilisée dans la génération de licences feuilles, qui s’effectue en appelant la méthode GetLeafLicenseResponse . L’interface IWMDRMNetTransmitter conserve une copie de la licence racine pour cette utilisation.

La licence racine créée en appelant cette méthode n’a pas de stratégies et est configurée de sorte qu’elle ne puisse pas être conservée sur l’appareil de réception.

Configuration requise

Condition requise Valeur
En-tête
Wmdrmsdk.h

Voir aussi

IWMDRMNetTransmitter, interface