IVssComponent::GetRestoreSubcomponent メソッド (vswriter.h)

  • [アーティクル]

GetRestoreSubcomponent メソッドは、指定されたコンポーネントに関連付けられている指定されたサブコンポーネントを返します。

ライターまたはリクエスターは、このメソッドを呼び出すことができます。

構文

HRESULT GetRestoreSubcomponent(
  [in]  UINT iComponent,
  [out] BSTR *pbstrLogicalPath,
  [out] BSTR *pbstrComponentName,
  [out] bool *pbRepair
);

パラメーター

[in] iComponent

サブコンポーネントのインデックス。 このパラメーターの値は、0 から n から 1 までの整数です。 n は、特定のコンポーネントに関連付けられているサブコンポーネントの合計数です。 n の値は、IVssComponent::GetRestoreSubcomponentCount によって返されます。

[out] pbstrLogicalPath

サブコンポーネントの論理パスを含む文字列へのポインター。 サブコンポーネントを操作する場合、論理パスを空にすることはできません。

[out] pbstrComponentName

サブコンポーネントの名前を含む文字列へのポインター。 空白の文字列は指定できません。

[out] pbRepair

将来利用するために予約されています。

戻り値

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

値 説明
S_OK
 属性値が正常に返されました。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_OBJECT_NOT_FOUND
 指定された項目が見つかりませんでした。

解説

呼び出し元は、SysFreeString を呼び出して pbstrLogicalPath パラメーターと pbstrComponentName パラメーターによって保持されているメモリを解放する必要があります。

要件

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

関連項目

IVssComponent