I_IrmProtector.HrProtectRMS メソッド
最終更新日: 2009年10月7日
適用対象: SharePoint Foundation 2010
指定された保護されていないファイルの、権限が管理されたバージョンを生成します。
HRESULT HrProtect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_ IrmPolicyInfoRMS *piid,
DWORD *pdwStatus
) PURE;
パラメーター
pilbInput
[in] 保護されていないファイル。
pilbOutput
[out] 指定された保護されていないファイルから Information Rights Management (IRM) プロテクタによって生成された、権限が管理されたストリーム。
piid
[in] 暗号化/解読プロセスを補助する関数とデータへのリンク。
pdwStatus
[in] メソッド呼び出しの状態。以下のいずれかの値を使用できます。
MSOIPI_STATUS_UNKNOWN
メソッドの結果を特定できません。
MSOIPI_STATUS_PROTECT_SUCCESS
プロテクタは、保護されたファイル ストリームの生成に成功しました。
MSOIPI_STATUS_ALREADY_PROTECTED
ファイルは既に IRM で保護されています。
MSOIPI_STATUS_CANT_PROTECT
プロテクタに何らかのエラーが発生しました。
MSOIPI_STATUS_NOT_MY_FILE
指定されたファイルは、この IRM プロテクタに関連付けられているファイルの種類ではありません。
MSOIPI_STATUS_FILE_CORRUPT
指定されたファイルは壊れています。
MSOIPI_STATUS_WSS_IRM_FAILED
プロテクタは SharePoint Foundation の関数にアクセスできません。または、これらの暗号化関数でエラーが発生しました。
MSOIPI_STATUS_BAD_INSTALL
プロテクタが正しくインストールされていません。
戻り値
プロテクタのメソッドは、一般的な HRESULT 値を返します。通常、プロテクタは、成功した場合は正の OK 値を返し、失敗した場合は負の FAIL 値を返す必要があります。
コメント
I_IrmProtector インターフェイスは、統合 IRM プロテクタと自律 IRM プロテクタの両方によって実装されます。統合および自律プロテクタの詳細については、「カスタム IRM プロテクタ」を参照してください。
統合 IRM プロテクタの場合 :
このメソッドは、IRM プロテクタが認識できる種類の保護されていないファイルを表すデータのストリームを受け取り、そのファイルの保護されたバージョンを表す対応するデータ ストリームを生成します。この保護されたバージョンには、保護されたファイルのドキュメント発行ライセンス (IL)、サーバーの EUL、および暗号化されたファイル コンテンツ自体が含まれます。
ファイル形式の開発者は、これらのデータ コンポーネントを、ファイル内のどこに、どのようにして格納するかを決定する必要があります。ただし、IRM プロテクタは、この種類のファイルの表示および編集に使用されるクライアント アプリケーションを考慮する必要があります。
保護されたストリームには、プロテクタのファイルの種類を表示するクライアント側のビューアの以前のバージョンと下位互換性のある警告メッセージを含めることもできます。
自律 IRM プロテクタの場合 :
自律プロテクタにはこのメソッドを実装する必要がありません。このメソッドが呼び出されると、自律プロテクタは HRESULT の E_NOTIMPL を返す必要があります。