SisCreateBackupStructure 関数
SisCreateBackupStructure 関数は、指定された情報に基づいて SIS バックアップ構造を作成します。
構文
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
パラメーター
-
volumeRoot [in]
-
バックアップするボリュームの、末尾の円記号を使用しないボリューム ルートのファイル名。 たとえば、"C:\" ではなく "C:" を指定します。
-
sisBackupStructure [out]
-
SIS バックアップ構造が返されました。
-
commonStoreRootPathname [out]
-
指定したボリュームの共通ストアの完全修飾パス名。 たとえば、"c:\SIS Common Store" などです。
-
countOfCommonStoreFilesToBackUp [out]
-
commonStoreFilesToBackUp パラメーターに一覧表示されているファイルの数。
-
commonStoreFilesToBackUp [out]
-
SIS が指定したボリュームの管理に使用する内部ファイルの一覧を指定するファイル名の配列へのポインター。 これらのファイルは、SisCSFilesToBackupForLink によって要求された共通ストア ファイルと同じ方法で同時にバックアップする必要があります
戻り値
この関数は、正常に完了した場合は TRUE を返し、それ以外の場合は FALSE を 返します。 GetLastError を呼び出して、呼び出しが失敗した理由の詳細を取得します。
注釈
この関数は SIS バックアップ構造を作成します。SIS バックアップ API は、ボリューム上のファイル リンクとリンク先の元のファイルの一覧を作成および管理するために使用されます。 この関数は、バックアップする SIS 対応ボリュームごとに 1 回だけ呼び出す必要があります。 指定されたボリューム内のすべてのファイルは、共通ストア ファイルとして扱われ、SIS が必要と示す場合にのみバックアップする必要があります。
countOfCommonStoreFilesToBackUp パラメーターと commonStoreFilesToBackUp パラメーターは、バックアップするリンクに関係なくバックアップする必要があるファイルの一覧を返します。
countOfCommonStoreFilesToBackUp が 0 の場合、commonStoreFilesToBackUp は NULL ポインターである可能性があります。 commonStoreFilesToBackUp パラメーターの値は無視する必要があります。
バックアップ操作が完了したら、SisFreeAllocatedMemory を呼び出して、文字列の commonStoreFilesToBackUp 配列で使用されるメモリの割り当てを解除します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|
| ライブラリ |
|
| [DLL] |
|