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를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.

설명

이 메서드는 비동기적으로 실행됩니다. 호출된 직후를 반환한 다음 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 이벤트 모델 사용을 참조하세요.

요구 사항

요구 사항	값
헤더	Wmdrmsdk.h
라이브러리	Wmdrmsdk.lib

추가 정보

자동화된 구성 요소 해지 및 갱신

DRM 개별화 예제

IWMDRMSecurity 인터페이스

DRM 개별화 수행