IWMDRMLicenseManagement::RestoreLicenses 메서드

[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 작성기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

RestoreLicenses 메서드는 BackupLicenses 메서드를 호출하여 만든 라이선스 백업에서 라이선스를 복원합니다.

구문

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

매개 변수

bstrBackupDirectory [in]

라이선스를 복원할 위치의 UNC 경로입니다.

dwFlags [in]

사용할 복원 옵션을 지정하는 플래그입니다. 현재 지원되는 유일한 플래그는 WMDRM_RESTORE_INDIVIDUALIZE, 필요한 경우 복원의 일부로 개별화를 수행하도록 메서드를 구성합니다.

ppunkCancelationCookie [out]

이 비동기 호출을 식별하는 개체의 IUnknown 인터페이스에 대한 포인터를 수신하는 포인터입니다. 이 인터페이스 포인터를 사용하여 IWMDRMEventGenerator::CancelAsyncOperation 메서드를 호출하여 비동기 호출을 취소할 수 있습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.

설명

이 메서드는 비동기적으로 실행됩니다. 호출된 직후를 반환한 다음, 처리가 완료되면 일련의 MEWMDRMLicenseRestoreProgress 이벤트와 MEWMDRMLicenseRestoreCompleted 이벤트가 차례로 생성됩니다. IMFMediaEvent::GetValue를 호출하여 얻은 각 MEWMDRMLicenseRestoreProgress 이벤트의 값은 IUnknown 포인터입니다. 검색된 IUnknown 인터페이스의 QueryInterface 메서드를 호출하여 IWMDRMLicenseBackupRestoreStatus 인터페이스의 instance 가져올 수 있습니다.

Windows Media DRM 클라이언트 확장 API의 비동기 메서드를 사용하는 방법에 대한 자세한 내용은 Media Foundation 이벤트 모델 사용을 참조하세요.

백업은 로컬 컴퓨터 또는 다른 컴퓨터에서 사용할 수 있습니다.

요구 사항

요구 사항	값
헤더	Wmdrmsdk.h
라이브러리	Wmdrmsdk.lib

추가 정보

IWMDRMLicenseManagement 인터페이스