다음을 통해 공유


IWMDMStorage4::GetRightsWithProgress 메서드(mswmdm.h)

GetRightsWithProgress 메서드는 스토리지 개체에 대한 권한 정보를 검색하여 진행률을 모니터링하기 위한 콜백 메커니즘을 제공합니다.

구문

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

매개 변수

[in] pIProgressCallback

Windows Media 장치 관리자 애플리케이션에 진행률을 다시 보고하는 데 사용할 IWMDMProgress3 인터페이스에 대한 선택적 포인터입니다.

[out] ppRights

스토리지 개체 권한 정보를 포함하는 WMDMRIGHTS 구조체의 배열에 대한 포인터입니다. 이 배열의 메모리는 Windows Media 장치 관리자 할당됩니다. 호출하는 애플리케이션이 이 배열에 대한 액세스를 완료하면 CoTaskMemFree를 사용하여 메모리를 해제해야 합니다.

[out] pnRightsCount

ppRights 배열의 WMDMRIGHTS 구조체 수에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

  • 표준 COM 오류 코드
  • HRESULT 값으로 변환된 Windows 오류 코드
  • Windows Media 장치 관리자 오류 코드
가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

개체 권한은 디지털 미디어 콘텐츠에 대한 사용 권한을 설명합니다. 예를 들어 WMDMRIGHTS 구조체에는 파일을 재생할 수 있는 횟수 및 재생할 수 있는 사용자에 대한 정보가 포함될 수 있습니다.

사용이 허가된 파일에서 권한을 검색하는 것은 경우에 따라 긴 요청일 수 있습니다. 이 함수를 사용하면 권한 요청을 비동기적으로 수행할 수 있습니다.

보안 콘텐츠 공급자는 진행률 알림 외에도 콜백 pIProgressCallback 에서 이벤트 알림을 생성할 수 있습니다. 이러한 이벤트의 예로는 보안 클록 획득, DRM 초기화 등이 있습니다. 이러한 이벤트는 IWMDMProgress3::P rogress3에 설명되어 있습니다.

이 메서드는 진행률을 반환하고 매개 변수 확인을 위해 MAC을 제공하지 않는다는 점을 제외하고 IWMDMStorage::GetRights와 동일합니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 mswmdm.h
라이브러리 Mssachlp.lib

추가 정보

IWMDMStorage4 인터페이스