IWMDRMLicenseQuery::QueryLicenseState 메서드
[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 작성기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
QueryLicenseState 메서드는 하나 이상의 특정 권한에 대한 키 ID에 적용되는 라이선스 정보를 로컬 라이선스 저장소에 쿼리합니다.
구문
HRESULT QueryLicenseState(
[in] BSTR bstrKID,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);
매개 변수
-
bstrKID [in]
-
쿼리할 키 ID입니다. 이 키 ID에 적용되는 라이선스만 평가됩니다.
-
cActionsToQuery [in]
-
쿼리할 작업 수입니다. 이 값은 rgbstrActionsToQuery 및 rgResultStateData 매개 변수에 대해 전달된 배열의 요소 수로 설정해야 합니다.
-
rgbstrActionsToQuery[] [in]
-
쿼리할 하나 이상의 권한 배열입니다. 이 배열은 cActionsToQuery에 지정된 만큼의 요소를 포함해야 합니다. 각 요소는 다음 상수 중 하나로 설정해야 합니다.
상수 설명 g_wszWMDRM_LicenseState_Backup 라이선스를 백업하고 복원할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_CollaborativePlay 공동 작업 재생 시나리오의 일부로 사용자 그룹과 콘텐츠를 공유할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_Copy 외부 디바이스 또는 미디어에 콘텐츠를 복사할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_CopyToCD 콘텐츠를 CD에 복사할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_CopyToNonSDMIDevice SDMI(보안 디지털 미디어 이니셔티브)를 지원하지 않는 디바이스에 콘텐츠를 복사할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_CopyToSDMIDevice SDMI를 지원하는 디바이스에 콘텐츠를 복사할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_CreateThumbnailImage 콘텐츠에서 썸네일 이미지를 만들 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_Playback 콘텐츠를 재생할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. g_wszWMDRM_LicenseState_PlaylistBurn 재생 목록의 일부로 콘텐츠를 CD에 복사할 수 있는 권한에 대한 세부 정보를 쿼리하려면 를 포함합니다. -
rgResultStateData[] [out]
-
rgbstrActionsToQuery 매개 변수의 해당 요소에서 오른쪽에 적용되는 라이선스 상태 정보를 수신하는 하나 이상의 DRM_LICENSE_STATE_DATA 구조체 배열입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
설명
지정된 키 ID에 적용되는 모든 라이선스가 검색 및 평가됩니다. 결과는 집계되므로 각 DRM_LICENSE_STATE_DATA 구조에 여러 라이선스의 정보가 포함될 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|