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

復元されるコンポーネントに割り当てられている論理名を取得します。

構文

HRESULT GetRestoreName(
  [out] BSTR *pbstrName
);

[out] pbstrName

コンポーネントの復元名を含む null で終わるワイド文字列を受け取る呼び出し元割り当て変数のアドレス。

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

値	意味
S_OK	操作に成功しました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。

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

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

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

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

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