IWMDRMLicenseQuery::QueryActionAllowed 메서드
[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 기록기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
QueryActionAllowed 메서드는 로컬 라이선스 저장소에서 쿼리를 수행하여 지정된 키 ID에 적용되는 하나 이상의 DRM 작업에 대한 라이선스 상태 검색합니다.
구문
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
매개 변수
-
bstrKID [in]
-
쿼리할 키 ID입니다. 이 키 ID에 적용되는 라이선스만 평가됩니다.
-
bstrMinReqIndivVersion [in]
-
ASF 파일의 헤더에 지정된 최소 보안 버전입니다. 이 매개 변수는 선택 사항입니다. 이 정보 없이 쿼리를 수행하려면 NULL 을 전달합니다.
-
cActionsToQuery [in]
-
쿼리할 작업 수입니다. 이 값은 rgbstrActionsToQuery 및 rgdwQueryResult 매개 변수에 대해 전달된 배열의 요소 수로 설정해야 합니다.
-
rgbstrActionsToQuery[] [in]
-
쿼리할 하나 이상의 권한 배열입니다. 이 배열은 cActionsToQuery에 지정된 만큼의 요소를 포함해야 합니다. 각 요소는 다음 상수 중 하나로 설정해야 합니다.
상수 설명 g_wszWMDRM_ActionAllowed_Playback 콘텐츠를 재생할 수 있는 권한을 쿼리하려면 를 포함합니다. g_wszWMDRM_ActionAllowed_Copy 외부 디바이스 또는 미디어에 콘텐츠를 복사할 수 있는 권한을 쿼리하려면 를 포함합니다. g_wszWMDRM_ActionAllowed_PlaylistBurn 재생 목록의 일부로 콘텐츠를 CD에 복사할 수 있는 권한을 쿼리하려면 를 포함합니다. g_wszWMDRM_ActionAllowed_CreateThumbnailImage 콘텐츠에서 썸네일 이미지를 만들 수 있는 권한을 쿼리하려면 를 포함합니다. g_wszWMDRM_ActionAllowed_CopyToCD 콘텐츠를 CD에 복사할 수 있는 권한을 쿼리하려면 를 포함합니다. -
rgdwQueryResult[] [out]
-
rgbstrActionsToQuery에서 지정한 권한에 대한 쿼리 결과를 수신하는 하나 이상의 DWORD 변수 배열입니다. 작업이 허용되는 경우 해당 요소는 0으로 설정됩니다. 작업이 허용되지 않으면 요소는 비트 OR 연산을 사용하여 결합된 DRM_ACTION_ALLOWED_QUERY_RESULTS 열거형의 하나 이상의 값으로 설정됩니다. 이 배열은 cActionsToQuery에 지정된 만큼의 요소를 포함해야 합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
설명
재생 및 복사 권한을 쿼리할 때 먼저 환경 매개 변수를 설정하여 보다 정확한 결과를 얻을 수 있습니다. SetActionAllowedQueryParams 메서드를 사용하여 환경 매개 변수를 설정합니다. 번 오른쪽에 대한 쿼리 결과는 환경 매개 변수의 영향을 받지 않습니다. 기본값을 안전하게 사용할 수 있습니다.
QueryActionAllowed 메서드에서 반환된 결과는 로컬 라이선스 저장소에 있는 0개 이상의 라이선스에서 집계됩니다. 사용 가능한 결과가 발생하는 경우 메서드는 키 ID에 적용되는 모든 라이선스를 검색하지 못할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|