Udostępnij za pośrednictwem

Tworzenie kopii zapasowych i przywracanie licencji

  • Artykuł

[Funkcja skojarzona z tą stroną, windows Media Format 11 SDK, jest starszą funkcją. Został zastąpiony przez Source Reader i Sink Writer. Czytnik źródłowy i Zapisujący ujścia zostały zoptymalizowane pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał czytnika źródeł i modułu zapisywania ujścia zamiast zestawu SDK windows Media Format 11, jeśli jest to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

Procesy tworzenia kopii zapasowych i przywracania są asynchroniczne. Są one wyzwalane, gdy użytkownik wybierze polecenie menu lub opcję w aplikacji, aby utworzyć kopię zapasową lub przywrócić licencje. Należy zezwolić użytkownikowi na określenie lokalizacji, w których należy utworzyć kopię zapasową licencji i przywrócić je.

Aby utworzyć kopię zapasową licencji:

  1. Użyj funkcji WMCreateBackupRestorer, aby utworzyć obiekt modułu przywracania kopii zapasowej.
  2. Wywołaj metodę IWMBackupRestoreProps::SetProp, aby ustawić ścieżkę kopii zapasowej (lokalizację, w której będą zapisywane pliki, takie jak A:\ lub D:\Licenses).
  3. Wywołaj metodę IWMLicenseBackup::BackupLicenses, aby utworzyć kopię zapasową licencji na określoną ścieżkę.

Następujące zdarzenia są wysyłane do metody IWMStatusCallback::OnStatus:

  • WMT_BACKUPRESTORE_BEGIN wskazuje, że proces tworzenia kopii zapasowej został uruchomiony.
  • WMT_BACKUPRESTORE_END wskazuje, że proces tworzenia kopii zapasowej został ukończony.
  • WMT_RESTRICTED_LICENSE wskazuje, że nie można utworzyć kopii zapasowej co najmniej jednej licencji, ponieważ prawa zostały zablokowane przez właściciela zawartości.

Identyfikator klucza jest również uwzględniony w tym komunikacie. Jeśli zaimplementowano bazę danych dla chronionych plików zawierających identyfikator klucza i metadane, można wyświetlić użytkownikowi komunikat o określonym tytule (takim jak tytuł utworu), dla którego nie można utworzyć kopii zapasowej licencji. W przeciwnym razie komunikat musi być ogólny i poinformować użytkownika, że nie można utworzyć kopii zapasowej niektórych licencji.

Aby przywrócić licencje:

  1. Użyj funkcji WMCreateBackupRestorer, aby utworzyć obiekt przywracania kopii zapasowej.
  2. Wywołaj metodę IWMBackupRestoreProps::SetProp, aby ustawić ścieżkę przywracania do lokalizacji, w której są tworzone kopie zapasowe licencji.
  3. Wywołaj metodę IWMLicenseRestore::RestoreLicenses, aby przywrócić licencje z tej lokalizacji.

Następujące zdarzenia są wysyłane do metody IWMStatusCallback::OnStatus:

  • WMT_BACKUPRESTORE_CONNECTING wskazuje, że aplikacja łączy się z usługą zarządzania licencjami.
  • WMT_BACKUPRESTORE_DISCONNECTING wskazuje, że aplikacja rozłącza się z usługą zarządzania licencjami.
  • WMT_BACKUPRESTORE_BEGIN wskazuje, że proces przywracania został uruchomiony.
  • WMT_BACKUPRESTORE_END wskazuje, że proces przywracania został ukończony.

Notatka

DrM nie jest obsługiwana przez wersję tego zestawu SDK opartą na architekturze x64.

 

funkcji zarządzania prawami cyfrowymi

IWMBackupRestoreProps Interface

Interfejs IWMLicenseBackup

interfejs IWMLicenseRestore