SisCreateRestoreStructure 関数
SisCreateRestoreStructure 関数は、指定された情報に基づいて SIS 復元構造を作成します。
構文
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
パラメーター
-
volumeRoot [in]
-
バックアップするボリュームの、末尾の円記号を使用しないボリューム ルートのファイル名。 たとえば、"C:\" ではなく "C:" を指定します。 ボリュームをシステムボリュームまたはブートボリュームにすることはできません。
-
sisRestoreStructure [out]
-
SIS 復元構造体が返されました。 この構造体は、呼び出し元によって不透明として扱われる必要があります。
-
commonStoreRootPathname [out]
-
指定したボリュームの共通ストアの完全修飾パス名。 たとえば、"c:\SIS Common Store" などです。
-
countOfCommonStoreFilesToRestore [out]
-
commonStoreFilesToRestore パラメーターに一覧表示されているファイルの数。
-
commonStoreFilesToRestore [out]
-
SIS が指定したボリュームの管理に使用する内部ファイルの一覧を指定するファイル名の配列へのポインター。 これらのファイルは、 SisCSFilesToBackupForLink によって要求された共通ストア ファイルと同じ方法で、同時に復元する必要があります。
戻り値
この関数は、正常に完了した場合は TRUE を返し、それ以外の場合は FALSE を 返します。 GetLastError を呼び出して、呼び出しが失敗した理由の詳細を取得します。
注釈
この関数は、 SisCreateBackupStructure が指定したボリュームにバックアップ環境を確立する方法で、指定されたボリュームに復元環境を確立します。
これらの共通ストア ファイルまたはファイルがまだディスク上に存在する場合、この関数は必ずしもバックアップ メディア上の SIS リンクのセットに対応する共通ストア ファイルまたはファイルを識別するわけではないことに注意してください。 共通ストア ファイルのデータ ストリームの内容は、作成後に変更されることはありません。そのため、ファイルがディスク上に既に存在する場合は、復元する必要はありません。
共通ストア ファイル名は、バックアップ操作がアクセスしたのと同じ SIS 対応ボリュームで復元操作が発生しない場合でも、復元操作の整合性を確保するためにグローバルに一意です。
復元操作が完了したら、SisFreeAllocatedMemory を呼び出して、文字列の commonStoreFilesToRestore 配列で使用されるメモリの割り当てを解除します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|
| ライブラリ |
|
| [DLL] |
|