SisFreeRestoreStructure function

The SisFreeRestoreStructure function frees the memory allocated for the specified SIS restore structure, and performs tasks that prepare the SIS filter to properly set up the links created during the restore operation.

Syntax

BOOL SisFreeRestoreStructure(
  _In_ PVOID sisRestoreStructure
);

Parameters

sisRestoreStructure [in]

Pointer to a SIS restore structure returned from SisCreateRestoreStructure.

Return value

This function returns TRUE if it completes successfully and FALSE otherwise. Call GetLastError to get more information about the reason the call failed.

Remarks

Accessing the SIS links before the call to this function completes can result in a volume check or a partial read of the link's contents.

Note that it is not safe to assume that this only deallocates memory. For example, this function may also perform additional administrative operations for the SIS architecture. Therefore, call this function even if your restore operation will exit immediately afterward.

Requirements

Requirement Value
Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Sisbkup.h
Library
Sisbkup.lib
DLL
Sisbkup.dll

See also

SisCreateRestoreStructure