IWMDRMNetTransmitter::GetRootLicenseResponse-Methode
[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die GetRootLicenseResponse-Methode generiert eine Antwortnachricht für die Stammlizenz.
Syntax
HRESULT GetRootLicenseResponse(
[in] BSTR bstrKID,
[out] BYTE **ppbLicenseResponse,
[out] DWORD *pcbLicenseResponse
);
Parameter
-
bstrKID [in]
-
Base64-codierter Schlüsselbezeichner, der für die neue Stammlizenz verwendet werden soll. Der Schlüsselbezeichner sollte ein zufällig generierter GUID-Wert sein.
-
ppbLicenseResponse [out]
-
Adresse einer Variablen, die die Adresse der generierten Lizenzantwort empfängt. Wenn Sie mit diesen Daten fertig sind, müssen Sie den Arbeitsspeicher freigeben, indem Sie CoTaskMemFree aufrufen.
-
pcbLicenseResponse [out]
-
Adresse einer Variablen, die die Größe der Lizenzantwort in Bytes empfängt.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | Beschreibung |
|---|---|
|
Eine aktualisierte Inhaltssperrliste ist erforderlich. |
|
Die Methode wurde erfolgreich ausgeführt. |
Bemerkungen
Die generierte Stammlizenz wird mithilfe der Informationen aus den Lizenzanforderungsdaten erstellt, die für die Schnittstelle durch Aufrufen von SetLicenseChallenge verarbeitet werden.
Die Stammlizenz wird bei der Generierung von Blattlizenzen verwendet, die durch Aufrufen der GetLeafLicenseResponse-Methode erreicht wird. Die IWMDRMNetTransmitter-Schnittstelle verwaltet eine Kopie der Stammlizenz für diese Verwendung.
Die durch aufrufen dieser Methode erstellte Stammlizenz verfügt über keine Richtlinien und ist so konfiguriert, dass sie nicht auf dem empfangenden Gerät beibehalten werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|