IVssComponentEx::GetRollForward メソッド (vswriter.h)

コンポーネントのロールフォワード操作の種類を取得し、部分ロールフォワード操作の復元ポイントを取得します。

構文

HRESULT GetRollForward(
  [out] VSS_ROLLFORWARD_TYPE *pRollType,
  [out] BSTR                 *pbstrPoint
);

[out] pRollType

実行するロールフォワード操作の種類を示す VSS_ROLLFORWARD_TYPE 列挙値。

[out] pbstrPoint

ロールフォワード復元ポイントを指定する null で終わるワイド文字列を受け取る呼び出し元によって割り当てられた変数のアドレス。

このメソッドの有効なリターンコードを次に示します。

値	意味
S_OK	操作に成功しました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリ不足またはその他のシステムリソースです。

GetRollForward メソッドは、復元操作中にのみ呼び出すことができます。

GetRollForward の呼び出しが成功した場合、呼び出し元は SysFreeString 関数を呼び出すことによって pRollType パラメーターで返される文字列を解放する必要があります。

ライターは、バックアップスキーママスクで VSS_BS_ROLLFORWARD_RESTORE フラグを設定することで、このメソッドをサポートすることを示します。

詳細については、「 VSS 復元オプションの設定」を参照してください。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	vswriter.h (Vss.h、VsWriter.h を含む)
Library	VssApi.lib