次の方法で共有

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

セキュリティで保護されたコンテンツ プロバイダーが決定を下すために必要なデータを記述するフラグ。 このパラメーターは、出力メッセージ認証コードに含まれています。 次のフラグのうち少なくとも 1 つを使用する必要があります。

フラグ 説明
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
Library Mssachlp.lib

こちらもご覧ください

ISCPSecureQuery インターフェイス