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

GetNewTarget メソッドは、選択したコンポーネントまたはコンポーネントセットの新しいファイル復元の場所を返します。 (コンポーネントの選択については、「選択可能性と論理パスの操作」を参照してください)。

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

構文

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iNewTarget

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

[out] ppFiledesc

新しいターゲット復元場所情報を含む IVssWMFiledesc オブジェクトへの二重間接ポインター。

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

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

GetNewTarget によって返される新しいターゲットは、現在のコンポーネント内のファイルだけでなく、選択不可能なサブコンポーネント内のファイルに対してもかまいません。

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