IVssComponent

IVssComponent インターフェイスは、リクエスターのバックアップコンポーネントドキュメントに含まれるコンポーネントに関する情報を調査および変更するためのメソッドを持つ、C++(COM ではない)インターフェイスです。

GetLogicalPath メソッドは、このコンポーネントの論理パスを返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	このコンポーネントには論理パスがありません。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

呼び出し元は、SysFreeString を呼び出して pbstrPath パラメーターが保持するメモリを解放する必要があります。

論理パスはコンポーネントに必須ではありません。論理パスを持たないコンポーネントは S_FALSE を返します。

GetComponentType メソッドは、VSS_COMPONENT_TYPE 列挙体の観点から、このコンポーネントの種類を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

GetComponentName メソッドは、このコンポーネントの論理名を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	このコンポーネントには名前がありません。この状態は決して発生しないはずです。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

呼び出し元は、SysFreeString を呼び出して pwszName パラメーターが保持するメモリを解放する必要があります。

GetBackupSucceeded メソッドは、選択されたコンポーネントまたはコンポーネントセットのすべてのファイルをバックアップする一連の試行の状態を、VSS_FILE_RESTORE_STATUS 列挙体として返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	メソッドが BackupComplete イベントより前に呼び出されたため、バックアップの成否状態は未定義です。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

このメソッドは BackupComplete イベントより前に呼び出さないでください。イベントハンドラー CVssWriter::OnBackupComplete の実装内で使用することを想定しています。

GetAlternateLocationMappingCount メソッドは、リクエスターがデータの復元時に使用する代替場所マッピングの数を返します。このメソッドはライターまたはリクエスターのいずれからでも呼び出せます。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。

GetAlternateLocationMappingCount が返す代替場所マッピングの数は、現在のコンポーネント内のファイルだけでなく、その選択不可能なサブコンポーネント内のファイルにも起因する場合があります。

代替場所マッピングは復元操作中にのみ使用され、バックアップ操作中にのみ使用される代替パスと混同しないでください。

GetAlternateLocationMappingCount が返す数は、ファイルの復元の過程で使用される代替場所マッピングの数を指します。

この数は IVssBackupComponents::AddAlternativeLocationMapping の呼び出しによって更新されます。

GetAlternateLocationMapping は、ファイル復元のためのファイルセットの代替場所を返すために使用します。このメソッドはライターまたはリクエスターのいずれからでも呼び出せます。

このメソッドの有効な戻り値コードは次のとおりです。

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

GetAlternateLocationMapping が返す代替場所マッピングは、現在のコンポーネント内のファイルからだけでなく、その選択不可能なサブコンポーネント内のファイルからも取得される場合があります。

IVssComponent::GetAlternateLocationMapping が返す値は、 IVssExamineWriterMetadata::GetAlternateLocationMapping が返す値とも混同しないでください。

• IVssExamineWriterMetadata::GetAlternateLocationMapping は、必要に応じてファイルの復元先となり得る代替場所マッピングです。
• IVssComponent::GetAlternateLocationMapping は、ファイルが実際に復元された代替場所です。

次のいずれかに該当する場合、ファイルは常にその代替場所マッピングに復元される必要があります。

• (バックアップ時に設定された)復元方法が VSS_RME_RESTORE_TO_ALTERNATE_LOCATION である。
• (復元時に)復元ターゲットが VSS_RT_ALTERNATE に設定された。

いずれの場合も、代替場所マッピングが定義されていないことはライターのエラーとなります。

次のいずれかに該当する場合、ファイルは代替場所マッピングに復元できます。

• 復元方法が VSS_RME_RESTORE_IF_NOT_THERE であり、ファイルのバージョンがすでにディスク上に存在する。
• 復元方法が VSS_RME_RESTORE_IF_CAN_REPLACE であり、ファイルのバージョンがディスク上に存在し、置き換えできない。

代替場所マッピングは復元操作中にのみ使用され、バックアップ操作中にのみ使用される代替パスと混同しないでください。

GetAlternateLocationMapping が返すマッピングは、ファイルの復元の過程で使用される代替場所マッピングを指します。

代替場所マッピングは、 IVssBackupComponents::AddAlternativeLocationMapping によって IVssComponent オブジェクトに追加されます。

呼び出し元は、ppMapping パラメーターが指す IVssWMFiledesc オブジェクトの使用を終えたら、IUnknown::Release を呼び出して、そのパラメーターが保持するシステムリソースを解放する必要があります。

VSS におけるバックアップおよび復元のファイルの場所の詳細については、 既定以外のバックアップおよび復元場所を参照してください。

SetBackupMetadata メソッドは、コンポーネントにバックアップメタデータを設定します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_OBJECT_ALREADY_EXISTS	このコンポーネントに対して、プライベートメタデータはすでに書き込まれています。
VSS_E_BAD_STATE	このメソッドがライターから呼び出されなかったか、またはライターから呼び出された場合でも、バックアップ操作中に呼び出されなかったか、BackupComplete または BackupShutdown イベントの処理中に呼び出されました。

SetBackupMetadata は、バックアップ操作を記述するプライベートなライター固有のメタデータを設定します。

その形式は、いかなる VSS メタデータ仕様にも準拠する必要はありません。

GetBackupMetadata メソッドは、PrepareForBackup イベント中に CVssWriter::OnPrepareBackup が IVssComponent::SetBackupMetadata を使用して設定した可能性のある、プライベートなライター固有のバックアップメタデータを取得します。

  <a href="/windows/desktop/api/vswriter/nf-vswriter-cvsswriter-onpreparebackup">OnPrepareBackup</a> イベント中に追加されたバックアップメタデータを含む文字列を受け取る、呼び出し元が割り当てた変数のアドレス。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	このコンポーネントに関連付けられたバックアップメタデータはありません。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

このメソッドは、指定されたライターのロジックに応じて、任意のタイミングで呼び出すことができます。

バックアップメタデータが設定されていない場合、 GetBackupMetadata は S_FALSE を返します。

GetBackupMetadata の呼び出しが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、pbstrMetadata パラメーターで返される文字列を解放する責任があります。

AddPartialFile メソッドは、指定されたファイルの一部分のみをバックアップの対象とすること、およびその部分がどこであるかを示します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	このメソッドがライターから呼び出されなかったか、またはライターから呼び出された場合でも、復元操作中に呼び出されませんでした。

このメソッドを呼び出せるのはライターのみであり、ライターは復元操作中にこのメソッドを呼び出すことはできません。

範囲リスト(wszRanges)の構文は、offset1:length1, offset2:length2 という形式のコンマ区切りリストであり、各オフセットと長さはそれぞれバイトオフセットとバイト単位の長さを指定する 64 ビット整数です。オフセットと長さは、16 進数または 10 進数のいずれかの値で表現できます。

wszRange がすべてのオフセットと長さを含むファイル(範囲ファイル)を参照している場合、wszRange にはそのファイルへのフルパスのみが含まれます。

範囲ファイルは、次の形式のバイナリファイルである必要があります。

1. バックアップが必要な個別のファイル範囲の数を示す 64 ビット整数
2. 各範囲を 64 ビット整数のペアとして表現したもの。バックアップ対象ファイルへのオフセット(バイト単位)と、そのオフセットからバックアップするデータの長さ

いずれの場合も、範囲は、ファイルの残りの部分とは独立してバックアップされる、指定されたファイルの一部分を示します。

リクエスターは、 IVssComponent::GetPartialFile を使用して部分ファイル情報を取得し、 GetPartialFile が返すオフセットと長さの情報を使用して、復元時にディスク上のファイルのコピー内の適切な場所にバックアップされたセクションを復元できます。

AddPartialFile は、コンポーネント(またはコンポーネントがコンポーネントセットを定義している場合はそのサブコンポーネントの 1 つ)によってすでに管理されているファイルに適用できるほか、新しいファイルをコンポーネントに追加して、それが部分ファイル操作に参加することを示すこともできます。

参加させるファイルが新しいファイルであることを示す場合、そのファイルはシャドウコピーされたボリューム上に存在し、そのパス(wszPath)はコンポーネント(またはコンポーネントがコンポーネントセットを定義している場合はそのサブコンポーネントの 1 つ)内にすでにあるパスと一致するか、その配下にある必要があります。ただし、そのファイルのファイル指定(wszFileSpec)は、コンポーネント内のものと一致してはなりません。

新しく追加されたファイルは、代替場所マッピングをサポートしません。

GetPartialFileCount メソッドは、コンポーネントに関連付けられた部分ファイルの数を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。

GetPartialFile メソッドは、このコンポーネントに関連付けられた部分ファイルに関する情報を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	呼び出し元が、操作に対して正しい状態(バックアップまたは復元)にありません。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。
VSS_E_OBJECT_NOT_FOUND	指定された項目が見つかりませんでした。

呼び出し元は、SysFreeString を呼び出して、pbstrPath、pbstrFilename、pbstrRange、pbstrMetadata の各パラメーターが保持するメモリを解放する必要があります。

範囲は、ファイルの残りの部分とは独立してバックアップされる、指定されたファイルの一部分を示します。

範囲リスト(pbstrRanges)の構文は、offset1:length1, offset2:length2 という形式のコンマ区切りリストであり、各オフセットと長さはそれぞれバイトオフセットとバイト単位の長さを指定する 64 ビット整数です。オフセットと長さは、16 進数または 10 進数のいずれかの値で表現できます。

pbstrRanges がすべてのオフセットと長さを含むファイル(範囲ファイル)を参照している場合、pbstrRanges にはそのファイルへのフルパスが含まれている必要があります。

wszRange がすべてのオフセットと長さを含むファイル(範囲ファイル)を参照している場合、wszRange にはそのファイルへのフルパスが含まれている必要があります。

範囲ファイルは、次の形式のバイナリファイルである必要があります。

1. バックアップが必要な個別のファイル範囲の数を示す 64 ビット整数。
2. 各範囲を 64 ビット整数のペアとして表現したもの。バックアップ対象ファイルへのオフセット(バイト単位)と、そのオフセットからバックアップするデータの長さ。

範囲ファイルは部分ファイルとともにバックアップされているはずであり、通常はバックアップ元と同じ場所に復元されます。

ただし、範囲ファイルの復元先は、リクエスターによって変更される場合があります。リクエスターは IVssBackupComponents::SetRangesFilePath を使用してこれを示し、pbstrRanges が正しい範囲ファイルを示すようにバックアップコンポーネントドキュメントを更新します。

リクエスターは、 GetPartialFile が返す範囲情報を使用して、復元時にディスク上のファイルのコピー内の適切な場所にバックアップされたセクションを復元します。

IsSelectedForRestore メソッドは、現在のコンポーネントが復元対象として選択されているかどうかを判断します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	呼び出し元が、操作に対して正しい状態(バックアップまたは復元)にありません。

IsSelectedForRestore はコンポーネントモードでのみ意味を持ちます。

コンポーネントがコンポーネントセットを定義している場合、 IsSelectedForRestore はコンポーネントとそのすべてのサブコンポーネントの両方を指します。

GetAdditionalRestores メソッドは、増分復元または差分復元操作中にライターが使用し、指定されたコンポーネントを完全に取得するために追加の復元操作が必要かどうかを判断します。

このメソッドの有効な戻り値コードは次のとおりです。

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

GetAdditionalRestores が返す値は、復元操作中にリクエスターが IVssBackupComponents::SetAdditionalRestores を呼び出さない限り、false になります。

GetAdditionalRestores は、コンポーネントを完全に復元するために複数のバックアップセットを使用する必要があるかどうかを確認するために使用します。コンポーネントは、まずフルバックアップからデータを復元して取得され、その後、後続の 1 つ以上の増分バックアップまたは差分バックアップからそのデータが更新されることがあります。

GetAdditionalRestores メソッドは通常、 PostRestore イベントハンドラー(CVssWriter::OnPostRestore)の一部として明示的なリカバリーメカニズムをサポートするライター(たとえば Exchange Server や、SQL Server などのデータベースアプリケーション)によって使用されます。これらのアプリケーションでは、そのようなリカバリーの実行後に、追加の差分、増分、またはログの復元を行うことができないことがよくあります。

したがって、 GetAdditionalRestores がコンポーネントに対して true を返す場合、そのようなライターは明示的なリカバリーメカニズムを実行すべきではなく、追加の差分、増分、またはログの復元が行われることを想定する必要があります。

SetAdditionalRestores が false を返す場合、復元の終了後、 PostRestore イベントの処理時に、ライターはリカバリー操作を完了してオンラインに復帰できます。

GetNewTargetCount メソッドは、指定されたコンポーネントに関連付けられた新しいターゲット復元場所の数を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。

GetNewTarget メソッドは、選択されたコンポーネントまたはコンポーネントセットの新しいファイル復元場所を返します。

このメソッドの有効な戻り値コードは次のとおりです。

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

GetNewTarget が返す新しいターゲットは、現在のコンポーネント内のファイルのものだけでなく、その選択不可能なサブコンポーネント内のファイルのものである場合もあります。

AddDirectedTarget メソッドは、ファイルを復元する際に、そのファイル(ソースファイル)を再マッピングする必要があることを、ライターが復元時に示せるようにします。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	このメソッドがライターから呼び出されなかったか、またはライターから呼び出された場合でも、復元操作中に呼び出されなかったか、BackupComplete または BackupShutdown イベントの処理中に呼び出されました。

AddDirectedTarget を呼び出せるのはライターのみであり、復元操作中に限られます。

リクエスターは、復元ターゲットが VSS_RT_DIRECTED の場合にのみ、バックアップコンポーネントドキュメントに格納されたディレクテッドターゲット情報を使用します。

AddDirectedTarget メソッドは、現在のコンポーネントで管理されている任意のファイル、または、コンポーネントがコンポーネントセットを定義している場合はその選択不可能なサブコンポーネント内の任意のファイルに適用できます。

ソースと宛先のファイル指定は同じファイルを指してもかまいません。これにより、復元時にファイルをそれ自身に再マッピングできます。

範囲リスト(wszSourceRanges および wszDestinationRanges)の構文は、offset1:length1, offset2:length2 という形式のコンマ区切りリストであり、各オフセットと長さはそれぞれバイトオフセットとバイト単位の長さを指定する 64 ビット整数です。オフセットと長さは、16 進数または 10 進数のいずれかの値で表現できます。

エントリの数とそのサイズは、ソースと宛先の範囲引数で一致している必要があります。

AddDirectedTarget は、コンポーネント、またはコンポーネントがコンポーネントセットを定義している場合はそのサブコンポーネントの 1 つによってすでに管理されている任意のファイルをソースファイルとして使用できます。

バックアップ対象の部分ファイル範囲がディレクテッドターゲットのソース範囲と一致する場合、部分ファイルをディレクテッドターゲットとして追加できます( IVssComponent::AddPartialFile を参照)。これにより、復元時に部分ファイルを再マッピングできます。

この場合、リクエスターは IVssComponent::GetDirectedTarget メソッドを呼び出してディレクテッドターゲット情報を取得し、それを使用して復元時にバックアップされたデータの再マッピングを実装します。

GetDirectedTargetCount メソッドは、現在のコンポーネントに関連付けられたディレクテッドターゲット指定の数を返します。このメソッドはライターまたはリクエスターのいずれからでも呼び出せます。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。

GetDirectedTarget メソッドは、ファイルを復元する際にそのファイル(ソースファイル)を再マッピングする必要があることを示すために、ライターがバックアップ時にバックアップコンポーネントドキュメントに格納した情報を返します。

このメソッドの有効な戻り値コードは次のとおりです。

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

GetDirectedTarget の呼び出しが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された各文字列を解放する責任があります。

リクエスターは、復元ターゲットが VSS_RT_DIRECTED の場合にのみ、バックアップコンポーネントドキュメントに格納されたディレクテッドターゲット情報を使用します。

範囲リスト(wszSourceRanges および wszDestinationRanges)の構文は、offset1:length1, offset2:length2 という形式のコンマ区切りリストであり、各オフセットと長さはそれぞれバイトオフセットとバイト単位の長さを指定する 64 ビット整数です。オフセットと長さは、16 進数または 10 進数のいずれかの値で表現できます。

GetDirectedTarget がディレクテッドターゲットを返すファイルは、現在のコンポーネントのファイル、またはそれが定義する任意のサブコンポーネントのメンバーである場合があります。

呼び出し元は、SysFreeString を呼び出して、pbstrSourcePath、pbstrSourceFileName、pbstrSourceRangeList、pbstrDestinationPath、pbstrDestinationFilename、pbstrDestinationRangeList の各パラメーターが保持するメモリを解放する必要があります。

バックアップ対象の部分ファイル範囲がディレクテッドターゲットのソース範囲と一致する場合、部分ファイルをディレクテッドターゲットとして追加できます( IVssComponent::AddPartialFile を参照)。これにより、部分ファイルを再マッピングできます。

リクエスターは、復元を正しく実装するために、ディレクテッドターゲットのソースファイルが部分ファイルとしてバックアップされたかどうかを確認する必要があります。そうである場合、リクエスターはディレクテッドターゲット情報を部分ファイル情報(IVssComponent::GetPartialFile)と組み合わせて使用し、復元時にバックアップされたデータの再マッピングを実装します。

SetRestoreMetadata メソッドは、現在のコンポーネントにライター固有のメタデータを設定します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_OBJECT_ALREADY_EXISTS	このコンポーネントに対して、プライベートメタデータはすでに書き込まれています。
VSS_E_BAD_STATE	メソッドが、PreRestore イベントを処理するライターのコンテキスト外で呼び出されました。

IVssComponent::SetRestoreMetadata は、復元操作中にライターが使用できる、プライベートなライター固有のメタデータを設定します。

その形式は、いかなる VSS メタデータ仕様にも準拠する必要はありません。

GetRestoreMetadata メソッドは、PreRestore イベント中に CVssWriter::OnPreRestore が IVssComponent::SetRestoreMetadata を使用して設定した可能性のある、プライベートなライター固有の復元メタデータを取得します。

このメソッドの有効な戻り値コードは次のとおりです。

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

このメソッドは、指定されたライターのロジックに応じて、任意のタイミングで呼び出すことができます。

呼び出し元は、 SysFreeString を呼び出して pbstrRestoreMetadata パラメーターが保持するメモリを解放する必要があります。

バックアップメタデータが設定されていない場合、 GetBackupMetadata は S_FALSE を返します。

ライターが代替場所マッピングを定義せずに復元方法を VSS_RME_RESTORE_TO_ALTERNATE_LOCATION に設定することは、ライターのエラーとなります。

SetRestoreTarget メソッドは、現在のコンポーネントの復元ターゲットを(VSS_RESTORE_TARGET 列挙体の観点から)設定します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	呼び出し元が、操作に対して正しい状態(バックアップまたは復元)にありません。

SetRestoreTarget によって設定される復元ターゲットは、コンポーネント内のすべてのファイルおよびすべての選択不可能なサブコンポーネントに適用されます。

GetRestoreTarget メソッドは、現在のコンポーネントの復元ターゲットを(VSS_RESTORE_TARGET 列挙体の観点から)返します。

このメソッドの有効な戻り値コードは次のとおりです。

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

SetPreRestoreFailureMsg メソッドは、PreRestore イベントの処理における失敗を記述するメッセージを作成するために使用します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	失敗メッセージを正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	呼び出し元が、操作に対して正しい状態(バックアップまたは復元)にありません。

SetPreRestoreFailureMsg によって設定される失敗メッセージは、コンポーネント内のすべてのファイルおよびすべての選択不可能なサブコンポーネントに適用されます。

GetPreRestoreFailureMsg メソッドは、IVssComponent::SetPreRestoreFailureMsg が設定していた場合に、PreRestore イベントの処理中にライターが生成したエラーメッセージを取得します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	取得できる PreRestore の失敗メッセージがありませんでした。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

呼び出し元は、SysFreeString を呼び出して pbstrPreRestoreFailureMsg パラメーターが保持するメモリを解放する必要があります。

SetPreRestoreFailureMsg を使用して PreRestore の失敗メッセージが設定されていなかった場合、 GetPreRestoreFailureMsg は S_FALSE を返します。

SetPostRestoreFailureMsg メソッドは、PostRestore イベントの処理における失敗を記述するメッセージを作成するために使用します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	失敗メッセージを正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	呼び出し元が、操作に対して正しい状態(バックアップまたは復元)にありません。

SetPostRestoreFailureMsg によって設定される失敗メッセージは、コンポーネント内のすべてのファイルおよびすべての選択不可能なサブコンポーネントに適用されます。

GetPostRestoreFailureMsg メソッドは、IVssComponent::SetPostRestoreFailureMsg が設定していた場合に、PostRestore イベントの処理中にライターが生成した失敗メッセージを返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	取得できる PostRestore の失敗メッセージがありませんでした。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

呼び出し元は、SysFreeString を呼び出して pbstrPostRestoreFailureMsg パラメーターが保持するメモリを解放する必要があります。

SetPostRestoreFailureMsg を使用して PostRestore の失敗メッセージが設定されていなかった場合、 GetPreRestoreFailureMsg は S_FALSE を返します。

SetBackupStamp メソッドは、バックアップがいつ実行されたかを示す情報を含む文字列を設定します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	バックアップのタイムスタンプを正常に設定しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	このメソッドがライターから呼び出されなかったか、またはライターから呼び出された場合でも、バックアップ操作中に呼び出されなかったか、BackupComplete または BackupShutdown イベントの処理中に呼び出されました。

バックアップスタンプの詳細については、複雑なストアのバックアップにおけるライターの役割を参照してください。

SetBackupStamp によって設定されるバックアップスタンプは、コンポーネント内のすべてのファイルおよびそれが持つすべての選択不可能なサブコンポーネントに適用されます。

ライターは通常、 CVssWriter::OnPostSnapshot 内で PostSnapshot イベントを処理する際に SetBackupStamp を呼び出します。

リクエスターは、バックアップスタンプをバックアップコンポーネントドキュメントに格納するだけです。バックアップスタンプを直接使用したり、その解釈方法を知っている必要はありません。

リクエスターがバックアップスタンプを使用するのは、復元操作中に、 IVssBackupComponents::SetPreviousBackupStamp メソッドを使用して、格納されたタイムスタンプ文字列をライターが利用できるようにする場合のみです。

このため、バックアップスタンプの内容に形式上の制約はありません。時刻や日付の情報、論理シーケンス番号、または同じクラスのライターが最後のバックアップがいつ実行されたかを判断できるその他の情報を含めることができます。

GetBackupStamp メソッドは、指定されたコンポーネントに対してライターが格納したバックアップスタンプ文字列を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	このコンポーネントに関連付けられたタイムスタンプはありません。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

バックアップタイムスタンプが設定されていない場合、 GetBackupStamp は S_FALSE を返します。

GetBackupStamp の呼び出しが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、pbstrBackupStamp パラメーターで返される文字列を解放する責任があります。

返される文字列は、コンポーネント内のすべてのファイルおよびそれが持つすべての選択不可能なサブコンポーネントを指します。

GetBackupStamp が取得するバックアップスタンプは、通常、PostSnapshot イベントハンドラー CVssWriter::OnPostSnapshot 内から IVssComponent::SetBackupStamp を呼び出してライターが設定します。

リクエスターは、バックアップスタンプをバックアップコンポーネントドキュメントに格納するだけです。バックアップスタンプを直接使用したり、その生成方法を知っていたり、その形式を理解していたりする必要はありません。

GetPreviousBackupStamp メソッドは、リクエスターがバックアップコンポーネントドキュメントに読み込んだ以前のバックアップスタンプを返します。この値は、ファイルを差分または増分バックアップ操作に参加させるべきかどうかをライターが判断する際に使用されます。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	以前のバックアップタイムスタンプが設定されていません。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

バックアップスタンプの詳細については、複雑なストアのバックアップにおけるライターの役割および 複雑なストアのバックアップにおけるリクエスターの役割を参照してください。

呼び出し元は、SysFreeString を呼び出して pbstrBackupStamp パラメーターが保持するメモリを解放する必要があります。

以前のバックアップタイムスタンプがない場合、 GetPreviousBackupStamp は S_FALSE を返します。

返される文字列は、コンポーネント内のすべてのファイルおよびそれが持つすべての選択不可能なサブコンポーネントを指します。

GetPreviousBackupStamp が取得するバックアップスタンプは、リクエスターが IVssBackupComponents::SetPreviousBackupStamp を使用して設定します。

通常、 GetPreviousBackupStamp で見つかる値の設定に使用された文字列は、格納されたバックアップコンポーネントドキュメントから取得されたか、リクエスターが独自の内部レコードの一部として格納したものです。

GetBackupOptions メソッドは、リクエスターが IVssBackupComponents::SetBackupOptions を使用して、現在選択されているコンポーネントまたはコンポーネントセットを管理するライターに指定したバックアップオプションを返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	このコンポーネントにはバックアップオプションが指定されていません。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

バックアップオプションが設定されていない場合、S_FALSE が返されます。

GetBackupOptions の呼び出しが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、pbstrBackupOptions パラメーターで返される文字列を解放する責任があります。

GetRestoreOptions メソッドは、リクエスターが IVssBackupComponents::SetRestoreOptions を使用して現在のライターに指定した復元オプションを取得します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
S_FALSE	復元オプションが指定されていません。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

呼び出し元は、SysFreeString を呼び出して pbstrRestoreOptions パラメーターが保持するメモリを解放する必要があります。

復元オプションが設定されていない場合、S_FALSE が返されます。

GetRestoreSubcomponentCount メソッドは、コンポーネントに関連付けられたサブコンポーネントの数を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。

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

このメソッドの有効な戻り値コードは次のとおりです。

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

呼び出し元は、SysFreeString を呼び出して、pbstrLogicalPath および pbstrComponentName の各パラメーターが保持するメモリを解放する必要があります。

GetFileRestoreStatus メソッドは、選択されたコンポーネントまたはコンポーネントセットのすべてのファイルを復元する完了した試行の状態を、VSS_FILE_RESTORE_STATUS 列挙体として返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	メソッドが復元操作の一部として呼び出されませんでした。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

このメソッドは、 PostRestore イベントの後にのみ呼び出す必要があります。

このメソッドが、 IVssBackupComponents::AddComponent によってバックアップコンポーネントに追加されて復元対象として選択されていないコンポーネントに適用された場合、返される状態は未定義です。

ファイルセット(指定された 1 つまたは複数のファイル)を、ファイル全体を使用するタイムスタンプ付きの増分または差分バックアップに含めるために、最終更新タイムスタンプと照合して評価すべきであることを、ライターが示すために使用します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	差分ファイルを正常に追加しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_BAD_STATE	このメソッドがライターから呼び出されなかったか、またはライターから呼び出された場合でも、バックアップ操作中に呼び出されなかったか、BackupComplete または BackupShutdown イベントの処理中に呼び出されました。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。
VSS_E_UNEXPECTED	予期しないエラーです。エラーコードはエラーログファイルに記録されます。詳しくは、VSS におけるイベントとエラーの処理を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP:この値は Windows Server 2008 R2 および Windows 7 まではサポートされていません。代わりに E_UNEXPECTED が使用されます。

ライターは、コンポーネント内の特定のファイルを、一定の時刻以降に変更された場合にのみバックアップすべきであることを指定するために、このメソッドを呼び出します。詳細については、最終更新時刻によるバックアップを参照してください。

このメソッドは、最終更新スキーマ (VSS_BS_LAST_MODIFY)をサポートするライターのみが、バックアップ操作中にのみ呼び出すことができます。このメソッドを使用するライターは、タイムスタンプスキーマ(VSS_BS_TIMESTAMPED)をサポートする必要はありません。

AddDifferencedFilesByLastModifyTime によって追加されるファイルは、 IVssComponent::AddPartialFile によっても追加すべきではありません。

バックアップの種類(VSS_BACKUP_TYPE)が増分(VSS_BT_INCREMENTAL)の場合、 AddDifferencedFilesByLastModifyTime を使用するライターは、増分スキーマ(VSS_BS_INCREMENTAL)をサポートする必要があります。バックアップの種類が差分の場合、ライターは VSS_BS_DIFFERENTIAL スキーマをサポートする必要があります。

AddDifferencedFilesByLastModifyTime メソッドは、バックアップ操作の実際の開始前に、通常は PostSnapshot イベントの処理中に呼び出す必要があります( CVssWriter::OnPostSnapshot を参照)。

AddDifferencedFilesByLastModifyTime によって設定されたタイムスタンプ値が 0 以外の場合、リクエスターは、差分ファイルを差分または増分バックアップに含めるべきかどうかを判断する際に、自身のレコードやファイルシステム情報にかかわらず、この値を尊重する必要があります。

AddDifferencedFilesByLastModifyTime によって設定されたタイムスタンプ(ftLastModifyTime)が 0 の場合、リクエスターは、差分ファイルを差分または増分バックアップに含めるべきかどうかを判断するために、ファイルシステム情報と自身のレコードを使用できます。

リクエスターは、 IVssComponent::GetDifferencedFile を呼び出して、コンポーネントが管理する差分ファイルの数を取得します。

差分ファイルセットは、次のいずれかになります。

• 現在のコンポーネント、または(コンポーネントがコンポーネントセットを定義している場合は)そのサブコンポーネントのメンバー
• コンポーネントまたはサブコンポーネントにこれまで含まれていなかった新しいファイル。 AddDifferencedFilesByLastModifyTime メソッドを使用すると、ライターは、元のバックアップ以降に作成されたファイルを、増分または差分バックアップをサポートするためにコンポーネントに含めるべきであることを示せます。

すでにコンポーネントの一部であるファイルを参照する場合、 AddDifferencedFilesByLastModifyTime に指定してマッピングするパス、ファイル指定、および再帰フラグ(それぞれ wszPath、wszFileSpec、bRecursive)の組み合わせは、 IVssCreateWriterMetadata::AddFilesToFileGroup、 IVssCreateWriterMetadata::AddDatabaseFiles、または IVssCreateWriterMetadata::AddDatabaseLogFiles によってコンポーネントに追加されたファイルセットの 1 つと一致している必要があります。

コンポーネントに新しいファイルを追加する場合、 AddDifferencedFilesByLastModifyTime では、ライターは別のコンポーネントやライターが管理するファイルを追加すべきではありません。

IVssComponent インターフェイスには、 AddDifferencedFilesByLastModifyTime によって追加された新しいファイルの代替場所マッピングを変更または追加できるメソッドはありません。 新しいファイルに対応する代替場所マッピングがある場合は、その代替場所が使用されます。

サポートされていません。(IVssComponent.AddDifferencedFilesByLastModifyLSN)

このメソッドは値を返しません。

このコンポーネント(および、それが定義するコンポーネントセットの任意のサブコンポーネント)内で、増分バックアップまたは復元をサポートするライターによって差分ファイルとしてマークされたファイル指定の数を返します。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。

GetDifferencedFile メソッドは、差分ファイルとして増分または差分のバックアップまたは復元に参加させるファイルセット(指定された 1 つまたは複数のファイル)に関する情報を返します。つまり、それに関連するバックアップと復元は、(部分ファイルを使用するのではなく)ファイル全体がバックアップメディアとの間でコピーされるかのように実装されます。

このメソッドの有効な戻り値コードは次のとおりです。

値	意味
S_OK	属性値を正常に返しました。
E_INVALIDARG	パラメーター値のいずれかが無効です。
E_OUTOFMEMORY	呼び出し元のメモリまたはその他のシステムリソースが不足しています。
VSS_E_OBJECT_NOT_FOUND	指定されたインデックスに対応する差分ファイルが見つかりませんでした。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細についてはイベントログを確認してください。詳しくは、VSS におけるイベントとエラーの処理を参照してください。

GetDifferencedFile は、バックアップまたは復元操作中に、リクエスターまたはライターから呼び出せます。

GetDifferencedFile の呼び出しが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、pbstrPath および pbstrFilespec パラメーターで返される文字列を解放する責任があります。

ライターは、ファイルの実際のバックアップより前の任意のタイミング、通常は PostSnapshot イベント(CVssWriter::OnPostSnapshot)の処理中に、 IVssComponent::AddDifferencedFilesByLastModifyTime の呼び出しによって差分ファイルを示すことができます。そのため、バックアップ中は、 IVssBackupComponents::DoSnapshotSet が正常に返る前に GetDifferencedFile を呼び出しても有用ではありません。

GetDifferencedFile が返すタイムスタンプは、返されたパス(pbstrPath)およびファイル指定(pbstrFilespec)に一致するすべてのファイルに適用されます。

GetDifferencedFile が返すタイムスタンプ値(pftLastModifyTime)が 0 以外の場合、リクエスターは、差分ファイルを差分または増分バックアップに含めるべきかどうかを判断するために、自身のレコードやファイルシステム情報にかかわらずこの値を尊重し、それを使用する必要があります。

GetDifferencedFile が返すタイムスタンプが 0 の場合、リクエスターは、差分ファイルを差分または増分バックアップに含めるべきかどうかを判断するために、ファイルシステム情報と自身のレコードを使用できます。

差分ファイルは、次のいずれかになります。

• 現在のコンポーネントのメンバー、または、コンポーネントがコンポーネントセットを定義している場合は、 IVssCreateWriterMetadata::AddFilesToFileGroup、 IVssCreateWriterMetadata::AddDatabaseFiles、または IVssCreateWriterMetadata::AddDatabaseLogFiles を使用してコンポーネントに追加された、そのサブコンポーネントのメンバー
• IVssComponent::AddDifferencedFilesByLastModifyTime によってコンポーネントに追加された新しいファイル

すでにコンポーネントの一部であるファイルセットを参照する場合、 GetDifferencedFile を呼び出す際に使用するパス、ファイル指定、および再帰フラグ(それぞれ wszPath、wszFileSpec、bRecursive)の組み合わせは、コンポーネント、またはそのサブコンポーネントの 1 つ(コンポーネントがコンポーネントセットを定義している場合)内にすでにあるファイルセットのものと一致している必要があります。

GetDifferencedFile が差分の新しいファイルを返す場合、そのファイルのパス(pbstrPath)は、コンポーネント、またはそのサブコンポーネントの 1 つ(コンポーネントがコンポーネントセットを定義している場合)内にすでにあるパスと一致するか、その配下にある必要があります。

さらに、 GetDifferencedFile が返すファイルは、コンポーネントまたはライターによってすでに管理されているものであってはなりません。

これらの基準のいずれかに違反する場合、それはライター側のエラーであり、報告される必要があります。

IVssComponent インターフェイスには、 GetDifferencedFilesByLastModifyTime が返す新しいファイルの代替場所マッピングを変更または追加できるメソッドはありません。新しいファイルに対応する代替場所マッピングがある場合は、その代替場所が使用されます。

#define global IID_IVssComponent "{D2C72C96-C121-4518-B627-E5A93D010EAD}"
#usecom global IVssComponent IID_IVssComponent "{}"
#comfunc global IVssComponent_GetLogicalPath                       3 var
#comfunc global IVssComponent_GetComponentType                     4 var
#comfunc global IVssComponent_GetComponentName                     5 var
#comfunc global IVssComponent_GetBackupSucceeded                   6 var
#comfunc global IVssComponent_GetAlternateLocationMappingCount     7 var
#comfunc global IVssComponent_GetAlternateLocationMapping          8 int,sptr
#comfunc global IVssComponent_SetBackupMetadata                    9 wstr
#comfunc global IVssComponent_GetBackupMetadata                    10 var
#comfunc global IVssComponent_AddPartialFile                       11 wstr,wstr,wstr,wstr
#comfunc global IVssComponent_GetPartialFileCount                  12 var
#comfunc global IVssComponent_GetPartialFile                       13 int,var,var,var,var
#comfunc global IVssComponent_IsSelectedForRestore                 14 var
#comfunc global IVssComponent_GetAdditionalRestores                15 var
#comfunc global IVssComponent_GetNewTargetCount                    16 var
#comfunc global IVssComponent_GetNewTarget                         17 int,sptr
#comfunc global IVssComponent_AddDirectedTarget                    18 wstr,wstr,wstr,wstr,wstr,wstr
#comfunc global IVssComponent_GetDirectedTargetCount               19 var
#comfunc global IVssComponent_GetDirectedTarget                    20 int,var,var,var,var,var,var
#comfunc global IVssComponent_SetRestoreMetadata                   21 wstr
#comfunc global IVssComponent_GetRestoreMetadata                   22 var
#comfunc global IVssComponent_SetRestoreTarget                     23 int
#comfunc global IVssComponent_GetRestoreTarget                     24 var
#comfunc global IVssComponent_SetPreRestoreFailureMsg              25 wstr
#comfunc global IVssComponent_GetPreRestoreFailureMsg              26 var
#comfunc global IVssComponent_SetPostRestoreFailureMsg             27 wstr
#comfunc global IVssComponent_GetPostRestoreFailureMsg             28 var
#comfunc global IVssComponent_SetBackupStamp                       29 wstr
#comfunc global IVssComponent_GetBackupStamp                       30 var
#comfunc global IVssComponent_GetPreviousBackupStamp               31 var
#comfunc global IVssComponent_GetBackupOptions                     32 var
#comfunc global IVssComponent_GetRestoreOptions                    33 var
#comfunc global IVssComponent_GetRestoreSubcomponentCount          34 var
#comfunc global IVssComponent_GetRestoreSubcomponent               35 int,var,var,var
#comfunc global IVssComponent_GetFileRestoreStatus                 36 var
#comfunc global IVssComponent_AddDifferencedFilesByLastModifyTime  37 wstr,wstr,int,int
#comfunc global IVssComponent_AddDifferencedFilesByLastModifyLSN   38 wstr,wstr,int,wstr
#comfunc global IVssComponent_GetDifferencedFilesCount             39 var
#comfunc global IVssComponent_GetDifferencedFile                   40 int,var,var,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。