다음을 통해 공유


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

ExamineData 메서드는 Windows 미디어 장치 관리자 이 메서드에 전달하는 데이터를 검사하여 콘텐츠에 대한 권한과 책임을 결정합니다.

구문

HRESULT ExamineData(
  [in]      UINT     fuFlags,
  [in]      LPWSTR   pwszExtension,
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [in, out] BYTE [8] abMac
);

매개 변수

[in] fuFlags

결정을 내리기 위해 보안 콘텐츠 공급자에게 제공되는 데이터를 설명하는 플래그입니다. 다음 플래그가 있을 수 있습니다.

플래그 설명
WMDM_SCP_EXAMINE_DATA pData 매개 변수는 검사할 데이터를 가리킵니다.

[in] pwszExtension

보안 콘텐츠 공급자가 GetDataDemands 호출에서 확장을 요청하는지 검사할 파일 이름 확장명 포인터입니다.

[in] pData

검사할 파일의 시작 부분에 있는 데이터에 대한 포인터입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 하며 암호화되어야 합니다.

[in] dwSize

검사할 데이터의 길이(바이트)를 포함하는 DWORD입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 합니다.

[in, out] abMac

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

반환 값

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

반환 코드 Description
S_OK
메서드가 성공했습니다. 보안 콘텐츠 공급자는 이 콘텐츠를 담당합니다.
WMDM_E_CALL_OUT_OF_SEQUENCE
이 메서드는 시퀀스에서 호출되었습니다. GetDataDemands를 먼저 호출해야 합니다.
WMDM_E_MAC_CHECK_FAILED
메시지 인증 코드가 잘못되었습니다.
WMDM_E_MOREDATA
Windows Media 장치 관리자 다른 데이터 패킷을 사용하여 이 메서드를 다시 호출해야 합니다. 패킷의 크기는 GetDataDemands 메서드의 pdwMinExamineData 매개 변수에 의해 결정됩니다.
S_FALSE
보안 콘텐츠 공급자는 이 콘텐츠에 대해 책임을 지지 않습니다. 보안 콘텐츠 공급자와의 상호 작용을 종료합니다.
E_INVALIDARG
매개 변수가 잘못되었거나 NULL 포인터입니다.
E_FAIL
지정되지 않은 오류가 발생했습니다.

설명

이 메서드는 GetDataDemands 메서드 다음에 호출됩니다. 보안 콘텐츠 공급자는 이 메서드에 전달된 정보를 사용하여 콘텐츠에 대한 책임이 있는지 여부를 확인합니다. fuFlags 매개 변수는 검사를 위해 제공된 데이터를 확인하기 위해 참조됩니다. pData 매개 변수는 권한 및 책임 데이터의 시작을 가리킵니다. dwSize 매개 변수에는 권한 및 책임 데이터의 길이(바이트)가 포함됩니다.

WMDM_SCP_EXAMINE_DATA 플래그가 설정되면 pDataBuffer 매개 변수에 검사할 보안 콘텐츠 공급자에 대한 dwDataLength 바이트가 포함됩니다.

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

요구 사항

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

추가 정보

ISCPSecureQuery 인터페이스