다음을 통해 공유


ISCPSecureQuery::GetDataDemands 메서드(mswmdm.h)

GetDataDemands 메서드는 보안 콘텐츠 공급자가 지정된 콘텐츠 조각에 대한 권한과 책임을 결정하는 데 필요한 데이터를 보고합니다.

구문

HRESULT GetDataDemands(
  [out]     UINT     *pfuFlags,
  [out]     DWORD    *pdwMinRightsData,
  [out]     DWORD    *pdwMinExamineData,
  [out]     DWORD    *pdwMinDecideData,
  [in, out] BYTE [8] abMac
);

매개 변수

[out] pfuFlags

결정을 내리기 위해 보안 콘텐츠 공급자가 요구하는 데이터를 설명하는 플래그입니다. 이 매개 변수는 출력 메시지 인증 코드에 포함됩니다. 다음 플래그 중 하나 이상을 사용해야 합니다.

플래그 설명
WMDM_SCP_RIGHTS_DATA 보안 콘텐츠 공급자는 콘텐츠에 대한 권한을 결정하기 위해 데이터가 필요합니다.
WMDM_SCP_EXAMINE_DATA 보안 콘텐츠 공급자는 콘텐츠에 대한 책임이 있는지 여부를 확인하기 위해 데이터가 필요합니다.
WMDM_SCP_DECIDE_DATA 보안 콘텐츠 공급자는 콘텐츠를 다운로드할 수 있도록 허용할지 여부를 결정하는 데이터가 필요합니다.
WMDM_SCP_EXAMINE_EXTENSION 보안 콘텐츠 공급자는 파일 이름 확장명을 검사하여 콘텐츠를 다운로드할 수 있는지 여부를 확인해야 합니다.
WMDM_SCP_PROTECTED_OUTPUT 보안 콘텐츠 공급자에는 보호된 출력이 필요합니다.
WMDM_SCP_UNPROTECTED_OUTPUT 보안 콘텐츠 공급자에는 보호되지 않은 출력이 필요합니다.

[out] pdwMinRightsData

이 콘텐츠에 대한 권한을 결정하는 데 필요한 최소 데이터 양을 지정하는 DWORD 에 대한 포인터입니다. 이 매개 변수는 출력 메시지 인증 코드에 포함됩니다.

[out] pdwMinExamineData

보안 콘텐츠 공급자가 콘텐츠에 대한 책임 여부를 결정하는 데 필요한 최소 데이터 바이트 수를 포함하는 DWORD 에 대한 포인터입니다. 이 매개 변수는 출력 메시지 인증 코드에 포함됩니다.

[out] pdwMinDecideData

보안 콘텐츠 공급자가 콘텐츠를 다운로드할 수 있도록 허용할지 여부를 결정하는 데 필요한 최소 데이터 바이트 수를 포함하는 DWORD 에 대한 포인터입니다. 이 매개 변수는 출력 메시지 인증 코드에 포함됩니다.

[in, out] abMac

이 메서드의 매개 변수 데이터에 대한 메시지 인증 코드를 포함하는 8바이트 배열입니다. (WMDM_MAC_LENGTH 8로 정의됩니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패하면 HRESULT 오류 코드가 반환됩니다.

반환 코드 설명
WMDM_E_MAC_CHECK_FAILED
메시지 인증 코드가 잘못되었습니다.
E_INVALIDARG
매개 변수가 잘못되었거나 NULL 포인터입니다.
E_FAIL
지정되지 않은 오류가 발생했습니다.

설명

ISCPSecureQuery의 다른 메서드가 호출되기 전에 이 메서드를 호출해야 합니다.

이 메서드는 인증서 교환이 성공적으로 완료된 후에 호출됩니다. 보안 콘텐츠 공급자는 매개 변수를 콘텐츠에 대한 결정을 내리기 위한 요구 사항을 설명하는 플래그 및 데이터로 채웁니다.

보안 콘텐츠 공급자가 WMDM_SCP_RIGHTS_DATA 플래그를 설정하는 경우 Windows Media 장치 관리자 ISCPSecureQuery::GetRights를 호출하여 pdwMinRightsData에 지정된 데이터의 양을 보냅니다.

보안 콘텐츠 공급자가 WMDM_SCP_EXAMINE_DATA 플래그를 설정하는 경우 Windows Media 장치 관리자 ISCPSecureQuery::ExamineData를 호출하여 pdwMinExamineData에 지정된 데이터의 양을 보냅니다.

보안 콘텐츠 공급자가 WMDM_SCP_DECIDE_DATA 플래그를 설정하는 경우 Windows Media 장치 관리자 ISCPSecureQuery::MakeDecision을 호출하여 pdwMinDecideData에 지정된 데이터의 양을 보냅니다.

검사 플래그가 설정되지 않은 경우 Windows Media 장치 관리자 더 이상 호출하지 않습니다. 결정 플래그가 설정되지 않은 경우 Windows Media 장치 관리자 여전히 ISCPSecureQuery::ExamineData를 호출합니다.

이 메서드가 S_OK 반환하지 않으면 Windows Media 장치 관리자 이 보안 콘텐츠 공급자를 더 이상 호출하지 않습니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 mswmdm.h
라이브러리 Mssachlp.lib

추가 정보

ISCPSecureQuery 인터페이스