IWMDRMSecurity::GetContentEnablersFromHashes 메서드

[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 기록기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

GetContentEnablersFromHashes 메서드는 해시된 인증서를 기반으로 구성 요소를 갱신할 수 있는 콘텐츠 인에이블러 인터페이스를 검색합니다.

구문

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

매개 변수

rgpbCertHashes [in]

콘텐츠 사용자를 가져올 인증서 해시의 배열입니다.

cCerts [in]

콘텐츠 지원자를 검색할 인증서 수입니다. rgpbCertHashes 배열의 요소 수입니다.

hResultHint [in]

해지된 인증서로 인해 실패한 작업에서 받은 값을 반환합니다. 실패한 메서드 호출에 대한 응답으로 를 호출하지 않는 경우 를 S_OK.

prgContentEnablers [out]

새로 만든 IMFContentEnabler 인터페이스의 주소를 수신하는 배열입니다. pcContentEnablers 매개 변수의 콘텐츠 사용자 수를 얻으려면 NULL로 설정합니다.

pcContentEnablers [in, out]

prgContentEnablers 배열의 요소 수입니다. prgContentEnablersNULL인 경우 이 값은 출력에 필요한 콘텐츠 지원자 수로 설정됩니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

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

설명

IMFContentEnabler 인터페이스를 사용하여 해지된 구성 요소를 갱신하는 경우 사용자에게 프로세스를 명확히 해야 합니다. 이 설명은 업데이트 프로세스가 클라이언트 컴퓨터에서 Microsoft 웹 사이트로 정보를 전송하기 때문에 이 작업을 수행해야 합니다.

IMFContentEnabler::AutomaticEnable을 호출하면 콘텐츠 인에이블러가 Microsoft 웹 사이트에서 업데이트 서비스의 주소를 사용하여 기본 브라우저를 시작합니다. 해지된 구성 요소를 식별하는 고유 식별자가 업데이트 서비스로 전송됩니다. 그런 다음, 서비스는 사용자가 해지된 구성 요소의 새 버전을 다운로드하여 설치할 수 있는 웹 페이지로 브라우저를 리디렉션합니다.

요구 사항

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

추가 정보

IWMDRMSecurity 인터페이스