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 |