IWMDRMLicenseManagement::BackupLicenses-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 BackupLicenses-Methode erstellt eine Sicherung der Lizenzen im lokalen Lizenzspeicher.

Syntax

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

Parameter

bstrBackupDirectory [in]

UNC-Pfad des Speicherorts, an dem die Lizenzen gesichert werden.

dwFlags [in]

Flags, die die zu verwendenden Sicherungsoptionen angeben. Das einzige derzeit unterstützte Flag ist WMDRM_BACKUP_OVERWRITE, mit dem die Methode so konfiguriert wird, dass alle vorhandenen Sicherungsdateien im Verzeichnis überschrieben werden.

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 sofort nach dem Aufruf zurückgegeben und dann eine Reihe von MEWMDRMLicenseBackupProgress-Ereignissen generiert, gefolgt von einem MEWMDRMLicenseBackupCompleted-Ereignis , wenn die Verarbeitung abgeschlossen ist. Der Wert jedes MEWMDRMLicenseBackupProgress-Ereignisses , das durch aufrufen von IMFMediaEvent::GetValue abgerufen wird, 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.

Nicht alle Lizenzen dürfen gesichert werden. Diese Methode sichert nur Lizenzen, die dies zulassen.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

IWMDRMLicenseManagement-Schnittstelle