IWMDRMSecurity::P erformSecurityUpdate 메서드
[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 작성기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
PerformSecurityUpdate 메서드는 로컬 컴퓨터의 DRM 하위 시스템에 대한 보안 업데이트를 시작합니다.
구문
HRESULT PerformSecurityUpdate(
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
매개 변수
-
dwFlags [in]
-
다음 플래그 중 하나로 표시되는 업데이트 옵션입니다.
플래그 설명 WMDRM_SECURITY_PERFORM_INDIV 클라이언트 버전이 만료된 경우에만 DRM 구성 요소가 개별화되도록 합니다. WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH 클라이언트 컴퓨터의 해지 목록이 업데이트되도록 합니다. WMDRM_SECURITY_PERFORM_FORCE_INDIV 클라이언트 버전이 최신 상태인 경우에도 DRM 구성 요소가 개별화되도록 합니다. -
ppunkCancelationCookie [out]
-
이 작업을 취소하는 데 사용할 수 있는 개체에 대한 포인터를 수신하는 변수의 주소입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
설명
이 메서드는 비동기적으로 실행됩니다. 호출된 직후를 반환한 다음 dwFlags 매개 변수에 설정된 플래그에 따라 이벤트를 생성합니다.
개별화(WMDRM_SECURITY_PERFORM_INDIV 또는 WMDRM_SECURITY_PERFORM_FORCE_INDIV 플래그로 설정됨)의 경우 일련의 MEWMDRMIndividualizationProgress 이벤트가 생성되고 처리가 완료되면 MEWMDRMIndividualizationCompleted 이벤트가 생성됩니다. IMFMediaEvent::GetValue를 호출하여 얻은 각 MEWMDRMIndividualizationProgress 이벤트의 값은 IUnknown 포인터입니다. 검색된 IUnknown 인터페이스의 QueryInterface 메서드를 호출하여 IWMDRMIndividualizationStatus 인터페이스의 instance 가져올 수 있습니다.
해지 목록(플래그가 WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH 설정됨)을 새로 고치기 위해 처리가 완료되면 MEWMDRMREvocationDownloadCompleted 이벤트가 생성됩니다.
참고
PerformSecurityUpdate가 개별화를 완료하면 개별화된 새 상태를 반영하는 기존 개체는 IWMDRMSecurity에서 상속되는 개체뿐입니다. 다른 모든 기존 개체는 업데이트되지 않습니다. 개체가 개별화된 새 상태를 반영할 수 있도록 다른 개체를 해제하고 다시 만들어야 합니다.
Windows Media DRM 클라이언트 확장 API의 비동기 메서드를 사용하는 방법에 대한 자세한 내용은 Media Foundation 이벤트 모델 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|