IWMDRMNetTransmitter::GetRootLicenseResponse-Methode

Die GetRootLicenseResponse-Methode generiert eine Antwortnachricht der 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 durch Aufrufen von CoTaskMemFree frei geben.

alphabetLicenseResponse [ 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
NS _ E _ _ DRM-2016 _ ZU _ KLEIN
Eine aktualisierte Inhaltssperrliste ist erforderlich.
S _ OK
Die Methode wurde erfolgreich ausgeführt.

Bemerkungen

Die generierte Stammlizenz wird mithilfe der Informationen aus den Lizenzausforderungsdaten erstellt, die für die Schnittstelle durch Aufrufen von SetLicenseC anhand von 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.

Requirements (Anforderungen)

Anforderung Wert
Header
Wmdrmsdk.h

Weitere Informationen

IWMDRMNetTransmitter-Schnittstelle