Share via

SisRestoredLink 関数

  • [アーティクル]

SisRestoredLink 関数は、指定された復元された SIS リンクによって指される共通ストア ファイルまたはファイルの名前を返します。

構文

BOOL SisRestoredLink(
  _In_  PVOID  sisRestoreStructure,
  _In_  PWCHAR restoredFileName,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PULONG countOfCommonStoreFilesToRestore,
  _Out_ PWCHAR **commonStoreFilesToRestore
);

パラメーター

sisRestoreStructure [in]

SisCreateRestoreStructure から返される SIS 復元構造体へのポインター。

restoredFileName [in]

復元された SIS リンク ファイルの完全修飾ファイル名。

reparseData [in]

SIS 再解析ポイントの内容へのポインター。 この再解析ポイントには、復元された SIS リンクを記述するデータが含まれています。 ファイルの再解析ポイント データを取得するには、 FSCTL_GET_REPARSE_POINT コントロール コードを使用します。

reparseDataSize [in]

reparseData によって指される SIS 再解析ポイントの内容のサイズ (バイト単位)。

countOfCommonStoreFilesToRestore [out]

commonStoreFilesToRestore パラメーターに一覧表示されているファイルの数。

commonStoreFilesToRestore [out]

共通ストア ファイル名の配列へのポインター。 これらのファイルは、 SisCSFilesToBackupForLink によって要求された共通ストア ファイルと同じ方法で、同時に復元する必要があります。

countOfCommonStoreFilesToRestore パラメーターの値が 0 でない場合、commonStoreFilesToRestore パラメーターの値には、SIS リンクを復元した結果として復元される共通ストア ファイルの名前が含まれます。 値が 0 の場合は、共通ストア ファイルが 1 回返されたか、ボリュームに既に存在します。

戻り値

この関数は、正常に完了した場合は TRUE を返し、それ以外の場合は FALSE を 返します。 GetLastError を呼び出して、呼び出しが失敗した理由の詳細を取得します。

注釈

復元された SIS リンクごとに、この関数を呼び出す必要があります。

この関数は、復元操作ごとに各共通ストア ファイルを最大 1 回返します。同じ共通ストア ファイルを参照する追加の SIS リンクを復元しようとしても、その共通ストア ファイル名は返されません。

この関数は、メディアに格納されている SIS 再解析データが破損していないと仮定して、バックアップ操作中に SisCSFilesToBackupForLink の呼び出しでも返されなかった共通ストア ファイルを返しません。

SIS リンクを復元する場合、復元操作では、適切なスパース ファイルのみを作成し、割り当てられた範囲を初期化してから、バックアップ操作中に読み取られたとおりに SIS 再解析データを書き込む必要があります。 復元操作では、ゼロで初期化されたスパース ファイル (または非解析ファイル) ではなく、未割り当て範囲を持つスパース ファイルを作成することが重要です。

これらの共通ストア ファイルまたはファイルがまだディスク上に存在する場合、この関数は必ずしもバックアップ メディア上の一連の SIS リンクに対応する共通ストア ファイルまたはファイルを識別するわけではないことに注意してください。 共通ストア ファイルのデータ ストリームの内容は、作成後に変更されることはありません。そのため、ファイルがディスク上に既に存在する場合は、復元する必要はありません。

共通ストア ファイル名は、バックアップ操作がアクセスしたのと同じ SIS 対応ボリュームで復元操作が発生しない場合でも、復元操作の整合性を確保するためにグローバルに一意です。

要件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
Header
Sisbkup.h
ライブラリ
Sisbkup.lib
[DLL]
Sisbkup.dll

こちらもご覧ください

SisCreateRestoreStructure

SisCSFilesToBackupForLink