ISCPSecureQuery3::MakeDecisionOnClearChannel メソッド (mswmdm.h)
MakeDecisionOnClearChannel メソッドは、コンテンツへのアクセスをクリア チャネルで許可するかどうかを決定します。 アクセスが許可されている場合、このメソッドはコンテンツへのアクセスに使用されるインターフェイスを返します。
構文
HRESULT MakeDecisionOnClearChannel(
[in] UINT fuFlags,
[in] BYTE *pData,
[in] DWORD dwSize,
[in] DWORD dwAppSec,
[in] BYTE *pbSPSessionKey,
[in] DWORD dwSessionKeyLen,
[in] IMDSPStorageGlobals *pStorageGlobals,
[in] IWMDMProgress3 *pProgressCallback,
[in] BYTE *pAppCertApp,
[in] DWORD dwAppCertAppLen,
[in] BYTE *pAppCertSP,
[in] DWORD dwAppCertSPLen,
[in, out] LPWSTR *pszRevocationURL,
[in, out] DWORD *pdwRevocationURLLen,
[out] DWORD *pdwRevocationBitFlag,
[in, out] ULONGLONG *pqwFileSize,
[in] IUnknown *pUnknown,
[out] ISCPSecureExchange **ppExchange
);
パラメーター
[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 インターフェイスへのポインター。
[in] pProgressCallback
進行状況コールバック オブジェクトへのポインター。
[in] pAppCertApp
アプリケーション オブジェクトのアプリケーション証明書へのポインター。
[in] dwAppCertAppLen
アプリケーション証明書の長さ (バイト単位) を含む DWORD。
[in] pAppCertSP
サービス プロバイダー オブジェクトのアプリケーション証明書へのポインター。
[in] dwAppCertSPLen
アプリケーション証明書の長さ (バイト単位) を含む DWORD。
[in, out] pszRevocationURL
失効 URL を保持するバッファーへのポインター。
[in, out] pdwRevocationURLLen
rpszRevocationURL バッファーのサイズ (バイト単位) を含む DWORD へのポインター。
[out] pdwRevocationBitFlag
失効ビット フラグを含む DWORD へのポインター。 フラグ値は、ビットごとの OR を使用して組み合わされた 0 個または 1 つ以上の次のフラグ名になります。
| 値 | 説明 |
|---|---|
| WMDM_WMDM_REVOKED | Windows Media デバイス マネージャー自体が取り消されました。 |
| WMDM_APP_REVOKED | アプリケーションは取り消され、DRM で保護されたコンテンツを転送する前に更新する必要があります。 |
| WMDM_SP_REVOKED | サービス プロバイダーは取り消され、DRM で保護されたコンテンツを転送する前に更新する必要があります。 |
| WMDM_SCP_REVOKED | コンテンツ プロバイダーは取り消され、DRM で保護されたコンテンツを転送する前に更新する必要があります。 |
[in, out] pqwFileSize
ファイル サイズを含む QWORD へのポインター。 コンテンツ プロバイダーは、この値を更新するか、この時点でコピー先ファイルのサイズを決定できない場合は 0 に設定する必要があります。
[in] pUnknown
アプリケーションからの不明なインターフェイスへのポインター。
[out] ppExchange
交換インターフェイスを受け取る交換オブジェクトへのポインター。
戻り値
メソッドが成功した場合は、S_OK を返します。 メソッドが失敗すると、 HRESULT エラー コードが返されます。
| リターン コード | 説明 |
|---|---|
|
このメソッドは順序外で呼び出されました。 |
|
メッセージ認証コードが無効です。 |
|
Windows Media デバイス マネージャーは、別のデータ パケットを使用してこのメソッドを再度呼び出す必要があります。 パケットのサイズは、ISCPSecureQuery::GetDataDemands メソッドの pdwMinDecisionData パラメーターによって決まります。 |
|
呼び出し元には、要求された転送を実行するために必要な権限がありません。 |
|
パラメーターが無効であるか、 NULL ポインターです。 |
|
未指定のエラーが発生しました。 |
解説
このメソッドは ISCPSecureQuery2::MakeDecision2 と同じですが、このメソッドに渡されるパラメーターは暗号化されません。 そのため、このメソッドの方が効率的です。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | mswmdm.h |
| Library | Mssachlp.lib |