IWMDRMLicenseManagement::CleanLicenseStore 메서드

  • 아티클

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

CleanLicenseStore 메서드는 임시 라이선스 저장소에서 사용할 수 없는 라이선스를 제거하고 로컬 라이선스 저장소를 조각 모음하여 성능을 향상시킵니다.

구문

HRESULT CleanLicenseStore(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

매개 변수

dwFlags [in]

사용할 라이선스 저장소 정리 옵션을 지정하는 플래그입니다. 다음 표의 상수 중 하나로 설정합니다.

상수 설명
WMDRM_CLEAN_LICENSE_STORE_SYNC 클린 작업은 동기적으로 수행됩니다. 이 메서드는 작업이 완료될 때까지 반환되지 않습니다.
WMDRM_CLEAN_LICENSE_STORE_ASYNC 클린 작업은 비동기적으로 수행됩니다. 이 메서드는 즉시 반환됩니다. 작업이 완료되면 MELicenseStoreCleaned 미디어 이벤트가 전송됩니다.

ppunkCancelationCookie [out]

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

반환 값

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

반환 코드 설명
S_OK
 메서드가 성공했습니다.
DRM_E_LICENSENOTFOUND
 클라이언트 컴퓨터에 임시 라이선스 저장소가 없습니다.

설명

이 메서드는 비동기적으로 실행됩니다. 호출된 직후를 반환한 다음 처리가 완료되면 MEWMDRMLicenseStoreCleaned 이벤트를 생성합니다.

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

요구 사항

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

추가 정보

IWMDRMLicenseManagement 인터페이스