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 デバイス マネージャーは、ファイルの残りの部分をデバイスに直接転送できます。 |
[in, out] abMac
このメソッドのパラメーター データのメッセージ認証コードを含む 8 バイトの配列。 (WMDM_MAC_LENGTHは 8 と定義されています。
戻り値
メソッドが成功した場合は、S_OK を返します。 失敗した場合は、 HRESULT エラー コードが返されます。
リターン コード | 説明 |
---|---|
|
呼び出し元には、このインターフェイスの使用が許可されていません。 |
|
呼び出し元には、要求された操作を実行するために必要な権限がありません。 |
|
メッセージ認証コードが無効です。 |
|
メソッドが失敗しました。 セキュリティで保護されたコンテンツ プロバイダーとの対話を終了します。 |
|
パラメーターが無効であるか、 NULL ポインターです。 |
|
未指定のエラーが発生しました。 |
解説
Windows Media デバイス マネージャーは、コンテナー ファイルからセキュリティで保護されたコンテンツ プロバイダーにデータを転送して、このメソッドを繰り返し呼び出します。 Windows Media デバイス マネージャーは、最終的に dwSize を 0 に設定してこのメソッドを呼び出して、転送するデータがなくなったことを示します。 セキュリティで保護されたコンテンツ プロバイダーは、データを収集し、そこからさまざまなオブジェクトを抽出すると、呼び出しのたびに使用可能なオブジェクト (存在する場合) を Windows Media デバイス マネージャーに報告します。 使用可能なオブジェクトがない場合、セキュリティで保護されたコンテンツ プロバイダーは pfuReadyFlags パラメーターを 0 に設定してS_OKを返します。 セキュリティで保護されたコンテンツ プロバイダーが、転送されるファイルのそれ以上の処理や変更を必要としていないと判断すると、フラグ WMDM_SCP_NO_MORE_CHANGESが返されます。 Windows Media デバイス マネージャーは、ファイルの残りの部分をデバイスに直接転送できます。
オブジェクト データは、 ObjectData メソッドを呼び出すことによって、セキュリティで保護されたコンテンツ プロバイダーから転送されます。 Windows Media デバイス マネージャーは、2 番目のパラメーター dwBytesWrite で 0 が返されるまで ObjectData を繰り返し呼び出します。
TransferComplete メソッドは、セキュリティで保護されたデータ転送の終了を通知するために、Windows Media デバイス マネージャーによって呼び出されます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | mswmdm.h |
Library | Mssachlp.lib |