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

아티클
02/29/2024

MakeDecision 메서드는 콘텐츠에 대한 액세스가 허용되는지 여부를 결정합니다. 액세스가 허용되는 경우 이 메서드는 콘텐츠에 액세스하는 데 사용할 인터페이스를 반환합니다.

구문

HRESULT MakeDecision(
  [in]      UINT                fuFlags,
  [in]      BYTE                *pData,
  [in]      DWORD               dwSize,
  [in]      DWORD               dwAppSec,
  [in]      BYTE                *pbSPSessionKey,
  [in]      DWORD               dwSessionKeyLen,
  [in]      IMDSPStorageGlobals *pStorageGlobals,
  [out]     ISCPSecureExchange  **ppExchange,
  [in, out] BYTE [8]            abMac
);

매개 변수

[in] fuFlags

결정을 내리기 위해 보안 콘텐츠 공급자에게 제공되는 데이터를 설명하는 플래그입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 합니다. 다음 플래그가 있을 수 있습니다.

플래그	설명
WMDM_SCP_DECIDE_DATA	pData 매개 변수는 검사할 데이터를 가리킵니다.
WMDM_MODE_TRANSFER_PROTECTED	ISCPSecureExchange 인터페이스의 출력 개체 데이터를 보호해야 합니다. Windows Media 장치 관리자 모드 플래그를 설정하지 않거나 둘 다 설정하면 DRM은 ISCPSecureExchange 인터페이스의 출력 개체 데이터를 보호하거나 보호 해제해야 하는지 여부를 결정합니다.
WMDM_MODE_TRANSFER_UNPROTECTED	ISCPSecureExchange 인터페이스의 출력 개체 데이터는 보호되지 않아야 합니다. Windows Media 장치 관리자 모드 플래그를 설정하지 않거나 둘 다 설정하면 DRM은 ISCPSecureExchange 인터페이스의 출력 개체 데이터를 보호하거나 보호 해제해야 하는지 여부를 결정합니다.

[in] pData

검사할 데이터가 포함된 데이터 개체에 대한 포인터입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 하며 암호화되어야 합니다.

[in] dwSize

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

[in] dwAppSec

Windows Media 장치 관리자 현재 보안 수준을 나타내는 DWORD입니다. 이는 애플리케이션 및 대상 서비스 공급자의 현재 보안 수준 중 더 작습니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 합니다.

[in] pbSPSessionKey

pStgGlobals가 가리키는 서비스 공급자와의 통신을 보호하기 위한 세션 키가 포함된 바이트 배열에 대한 포인터입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 하며 암호화되어야 합니다.

[in] dwSessionKeyLen

pbSPSessionKey가 가리키는 바이트 배열의 길이입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 합니다.

[in] pStorageGlobals

파일이 전송되는 미디어 또는 디바이스의 루트 스토리지에 있는 IWMDMStorageGlobals 인터페이스에 대한 포인터입니다. 이 매개 변수는 입력 메시지 인증 코드에 포함되어야 합니다.

[out] ppExchange

교환 인터페이스를 수신하는 exchange 개체에 대한 포인터입니다.

[in, out] abMac

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

반환 값

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

반환 코드	설명
WMDM_E_CALL_OUT_OF_SEQUENCE	이 메서드는 시퀀스에서 호출되었습니다.
WMDM_E_MAC_CHECK_FAILED	메시지 인증 코드가 잘못되었습니다.
WMDM_E_MOREDATA	Windows Media 장치 관리자 다른 데이터 패킷을 사용하여 이 메서드를 다시 호출해야 합니다. 패킷의 크기는 ISCPSecureQuery::GetDataDemands 메서드의 pdwMinDecisionData 매개 변수에 의해 결정됩니다.
S_FALSE	호출자에게 요청된 전송을 수행하는 데 필요한 권한이 없습니다.
E_INVALIDARG	매개 변수가 잘못되었거나 NULL 포인터입니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.