IDedupBackupSupport::RestoreFiles method

Reconstructs a set of files from a backup store that contains the fully optimized version of the files (reparse points) and the Data Deduplication store.

Applications that call the RestoreFiles method must also implement the IDedupReadFileCallback interface. Before calling the RestoreFiles method, the application must have previously restored the Data Deduplication reparse points for the files to the location specified by the FileFullPaths parameter. Metadata located in the reparse points will be utilized by Data Deduplication to further drive the restore process.

After calling this method, applications can expect to receive two calls to IDedupReadFileCallback::OrderContainersRestore (one for stream map containers and one for data containers) and two or more calls to IDedupReadFileCallback::ReadBackupFile. The application will also receive one call to IDedupReadFileCallback::PreviewContainerRead before each call to ReadBackupFile that is directed to a container file.

Syntax


HRESULT RestoreFiles(
  [in]                          ULONG                  NumberOfFiles,
  [in, size_is(NumberOfFiles)]  BSTR                   *FileFullPaths,
  [in]                          IDedupReadFileCallback *Store,
  [in]                          DWORD                  Flags,
  [out, size_is(NumberOfFiles)] HRESULT                *FileResults
);

Parameters

NumberOfFiles [in]

The number of files to restore. If this exceeds 10,000 then the method will fail with E_INVALIDARG (0x80070057).

FileFullPaths [in]

For each file, this parameter contains the full path from the root directory of the volume to the reparse point previously restored by the application.

Store [in]

IDedupReadFileCallback interface pointer for the backup store. This parameter is required and cannot be NULL.

Flags [in]

This parameter must be DEDUP_RECONSTRUCT_UNOPTIMIZED on input. For more information, see the DEDUP_BACKUP_SUPPORT_PARAM_TYPE enumeration.

FileResults [out]

For each file, this parameter contains the results of the restore operation for that file. This parameter is optional and can be NULL if the application doesn't need to know the results for each individual file.

S_OK (0x00000000L)

The file was restored successfully.

S_FALSE (0x00000001L)

The specified file is not a deduplicated file.

DDP_E_FILE_CORRUPT (0x80565355L)

Data deduplication encountered a file corruption error.

DDP_E_FILE_SYSTEM_CORRUPT (0x8056530EL)

Data deduplication encountered a file system corruption error.

DDP_E_INVALID_DATA (0x8056531DL)

The data is not valid.

DDP_E_JOB_COMPLETED_PARTIAL_SUCCESS (0x80565356L)

The operation completed with some errors. Check the event logs for more details.

Windows Server 2012:  This value is not supported before Windows Server 2012 R2.

DDP_E_NOT_FOUND (0x80565301L)

The requested object was not found.

DDP_E_PATH_NOT_FOUND (0x80565304L)

A specified container path was not found in the backup store.

DDP_E_UNEXPECTED (0x8056530CL)

Data deduplication encountered an unexpected error. Check the Data Deduplication Operational event log for more information.

DDP_E_VOLUME_DEDUP_DISABLED (0x80565323L)

The specified volume is not enabled for deduplication.

DDP_E_VOLUME_UNSUPPORTED (0x8056530bL)

The specified volume type is not supported. Deduplication is supported on fixed, write-enabled NTFS data volumes.

Windows Server 2012:  This value is not supported before Windows Server 2012 R2.

Return value

This method can return standard HRESULT values, such as S_OK. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. You can test for success or failure HRESULT values by using the SUCCEEDED and FAILED macros defined in Winerror.h. Possible return values include the following.

If no file was restored successfully, the result is the first file error encountered. This will be one of the "DDP_E_XXX" error codes above.

S_OK

0x00000000L

All files were restored successfully.

S_FALSE

0x00000001L

None of the specified files are deduplicated files.

E_INVALIDARG

0x80070057L

An input parameter is NULL or otherwise not valid.

DDP_E_JOB_COMPLETED_PARTIAL_SUCCESS

0x80565356L

Some deduplicated files were restored successfully, but not all.

Remarks

The Store parameter is required because the restore engine (implemented by Data Deduplication) can read data from the backup media only by calling the IDedupReadFileCallback::ReadBackupFile method.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Header

DdpBackup.h

IDL

DdpBackup.idl

IID

CLSID_DedupBackupSupport is defined as 73D6B2AD-2984-4715-B2E3-924C149744DD

IID_IDedupBackupSupport is defined as C719D963-2B2D-415E-ACF7-7EB7CA596FF4

LIBID_DedupBackup is defined as 07AD57AF-6171-455B-B500-FEB99A6F4CF4

See also

IDedupBackupSupport
IDedupReadFileCallback
DEDUP_BACKUP_SUPPORT_PARAM_TYPE

 

 

Show: