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 오류 코드가 반환됩니다.
반환 코드 | 설명 |
---|---|
|
메시지 인증 코드가 잘못되었습니다. |
|
매개 변수가 잘못되었거나 NULL 포인터입니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
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 |