IWMDRMLicenseManagement::CreateLicenseRevocationChallenge-Methode

Artikel
06/21/2023

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Sie wurde durch den Quellleser und den Senkenschreiber ersetzt. Quellleser und Senkenschreiber wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit den Quellleser und senkenden Writer anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die CreateLicenseRevocationChallenge-Methode generiert eine Lizenzsperrungsanforderung.

Syntax

HRESULT CreateLicenseRevocationChallenge(
  [in]  BYTE  *pbMachineID,
  [in]  DWORD cbMachineID,
  [in]  BYTE  *pbChallenge,
  [in]  DWORD cbChallenge,
  [out] BYTE  **ppbChallengeOutput,
  [out] DWORD *pcbChallengeOutput
);

Parameter

pbMachineID [in]: Benutzerdefinierter Computerbezeichner. Dieser Wert wird verwendet, um eine Lizenz auf dem Server abzufragen und muss dem Format entsprechen, das der Lizenzserver verwendet.
cbMachineID [in]: Größe des Computerbezeichners in Bytes.
pbChallenge [in]: Benutzerdefinierte Anforderungsdaten. Diese Daten werden zusätzlich zum Computerbezeichner verwendet, um den Lizenzserver nach lizenzen abzufragen, die widerrufen werden sollen.
cbChallenge [in]: Größe der Challenge-Daten in Bytes.
ppbChallengeOutput [out]: Adresse eines Zeigers, der die Adresse der Challenge-Ausgabe empfängt. Bei diesem Puffer handelt es sich um die Daten, die an den Lizenzsperrdienst gesendet werden. Wenn Sie mit diesen Daten fertig sind, müssen Sie den Arbeitsspeicher freigeben, indem Sie CoTaskMemFree aufrufen.
pcbChallengeOutput [out]: Adresse einer Variablen, die die Größe der zugeordneten Ausgabedaten der Herausforderung 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
S_OK	Die Methode wurde erfolgreich ausgeführt.

Bemerkungen

Keine.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h

Siehe auch

IWMDRMLicenseManagement-Schnittstelle

Freigeben über