IWMDRMLicenseManagement::RestoreLicenses-Methode

[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 RestoreLicenses-Methode stellt Lizenzen aus einer Lizenzsicherung wieder her, die durch Aufrufen der BackupLicenses-Methode erstellt wurde.

Syntax

HRESULT RestoreLicenses(
  [in]  BSTR     bstrBackupDirectory,
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parameter

bstrBackupDirectory [in]

UNC-Pfad des Speicherorts, von dem die Lizenzen wiederhergestellt werden.

dwFlags [in]

Flags, die die zu verwendenden Wiederherstellungsoptionen angeben. Das einzige derzeit unterstützte Flag ist WMDRM_RESTORE_INDIVIDUALIZE, mit dem die Methode für die Durchführung der Individualisierung im Rahmen der Wiederherstellung konfiguriert wird, falls erforderlich.

ppunkCancelationCookie [out]

Zeiger, der einen Zeiger auf die IUnknown-Schnittstelle eines Objekts empfängt, das diesen asynchronen Aufruf identifiziert. Dieser Schnittstellenzeiger kann verwendet werden, um den asynchronen Aufruf abzubrechen, indem die IWMDRMEventGenerator::CancelAsyncOperation-Methode aufgerufen wird.

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

Diese Methode wird asynchron ausgeführt. Es wird unmittelbar nach dem Aufruf zurückgegeben und dann eine Reihe von MEWMDRMLicenseRestoreProgress-Ereignissen generiert, gefolgt von einem MEWMDRMLicenseRestoreCompleted-Ereignis , wenn die Verarbeitung abgeschlossen ist. Der Wert der einzelnen MEWMDRMLicenseRestoreProgress-Ereignisse , die durch aufrufen von IMFMediaEvent::GetValue abgerufen werden, ist ein IUnknown-Zeiger . Sie können die QueryInterface-Methode der abgerufenen IUnknown-Schnittstelle aufrufen, um eine instance der IWMDRMLicenseBackupRestoreStatus-Schnittstelle abzurufen.

Weitere Informationen zur Verwendung der asynchronen Methoden der erweiterten Windows Media DRM-Client-APIs finden Sie unter Verwenden des Media Foundation-Ereignismodells.

Die Sicherung kann vom lokalen Computer oder von einem anderen Computer stammen.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseManagement-Schnittstelle