次の方法で共有

ISCPSecureExchange::TransferContainerData メソッド (mswmdm.h)

  • [アーティクル]

TransferContainerData メソッドは、コンテナー ファイル データをセキュリティで保護されたコンテンツ プロバイダーに転送します。 セキュリティで保護されたコンテンツ プロバイダーは、コンテナーを内部的に分割し、コンテナーから抽出されたコンテンツのどの部分が使用可能であるかを報告します。

構文

HRESULT TransferContainerData(
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [out]     UINT     *pfuReadyFlags,
  [in, out] BYTE [8] abMac
);

パラメーター

[in] pData

コンテナー ファイルから転送されている現在のデータを保持しているバッファーへのポインター。 このパラメーターは、入力メッセージ認証コードに含まれている必要があり、暗号化する必要があります。

[in] dwSize

バッファー内のバイト数を含む DWORD を します。 このパラメーターは、入力メッセージ認証コードに含まれている必要があります。

[out] pfuReadyFlags

コンテナー ファイルのどの部分を読み取る準備ができているかを示すフラグ。 このパラメーターは、出力メッセージ認証コードに含まれています。 次のフラグは、準備ができていることを示しています。

旗 形容
WMDM_SCP_TRANSFER_OBJECTDATA オブジェクトのデータは、ObjectData メソッドを呼び出すことによって使用できます。
WMDM_SCP_NO_MORE_CHANGES セキュリティで保護されたコンテンツ プロバイダーが、転送するファイルのそれ以上の処理や変更が必要ないと判断した場合に設定します。 Windows Media Device Manager は、残りのファイルをデバイスに直接転送できます。

[in, out] abMac

このメソッドのパラメーター データのメッセージ認証コードを含む 8 バイトの配列。 (WMDM_MAC_LENGTHは 8 と定義されます)。

戻り値

メソッドが成功すると、S_OKが返されます。 失敗した場合は、HRESULT エラー コードが返されます。

リターン コード 形容
WMDM_E_NOT_CERTIFIED
 呼び出し元は、このインターフェイスを使用する権限がありません。
WMDM_E_NORIGHTS
 呼び出し元には、要求された操作を実行するために必要な権限がありません。
WMDM_E_MAC_CHECK_FAILED
 メッセージ認証コードが無効です。
S_FALSE
 メソッドが失敗しました。 セキュリティで保護されたコンテンツ プロバイダーとの対話を終了します。
E_INVALIDARG
 パラメーターが無効であるか、NULL ポインターです。
E_FAIL
 指定されていないエラーが発生しました。

備考

Windows Media Device Manager は、このメソッドを繰り返し呼び出し、コンテナー ファイルからセキュリティで保護されたコンテンツ プロバイダーにデータを転送します。 Windows Media Device Manager は、最終的に dwSize 0 に設定してこのメソッドを呼び出して、転送するデータがなくなったことを示します。 セキュリティで保護されたコンテンツ プロバイダーは、データを収集し、そこからさまざまなオブジェクトを抽出すると、呼び出しのたびに使用可能なオブジェクト (存在する場合) を Windows Media Device Manager に報告します。 使用可能なオブジェクトがない場合、セキュリティで保護されたコンテンツ プロバイダーは、pfuReadyFlags パラメーターを 0 に設定してS_OKを返します。 セキュリティで保護されたコンテンツ プロバイダーが、転送されるファイルのそれ以上の処理や変更が必要ないと判断すると、フラグ WMDM_SCP_NO_MORE_CHANGESが返されます。 その後、Windows Media Device Manager は、残りのファイルをデバイスに直接転送できます。

オブジェクト データは、ObjectData メソッドを呼び出すことによって、セキュリティで保護されたコンテンツ プロバイダーから転送されます。 Windows Media Device Manager は、2 番目のパラメーター (dwBytesWrite )0 を返すまで、ObjectData を繰り返し呼び出します。

TransferComplete メソッドは、データの安全な転送の終了を通知するために Windows Media Device Manager によって呼び出されます。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー mswmdm.h
ライブラリ Mssachlp.lib

関連項目

ISCPSecureExchange インターフェイス の