IWsbApplicationBackupSupport::CheckConsistency method (wsbapp.h)

Checks the consistency of the VSS writer's components in the shadow copy after shadow copies are created for the volumes to be backed up.

Syntax

HRESULT CheckConsistency(
  [in, optional]  LPWSTR               wszWriterMetadata,
  [in, optional]  LPWSTR               wszComponentName,
  [in, optional]  LPWSTR               wszComponentLogicalPath,
  [in]            DWORD                cVolumes,
  [in, optional]  LPWSTR               *rgwszSourceVolumePath,
  [in, optional]  LPWSTR               *rgwszSnapshotVolumePath,
  [out, optional] IWsbApplicationAsync **ppAsync
);

Parameters

[in, optional] wszWriterMetadata

A string that contains the VSS writer's metadata.

[in, optional] wszComponentName

The name of the component or component set to be checked. This should match the name in the metadata that the wszWriterMetadata parameter points to.

[in, optional] wszComponentLogicalPath

The logical path of the component or component set to be checked. This should match the logical path in the metadata that the wszWriterMetadata parameter points to.

[in] cVolumes

The number of shadow copy volumes. The value of this parameter can range from 0 to MAX_VOLUMES.

[in, optional] rgwszSourceVolumePath

A pointer to an array of volume GUID paths, one for each of the source volumes. The format of a volume GUID path is "\?\Volume{GUID}".

[in, optional] rgwszSnapshotVolumePath

A pointer to an array of volume GUID paths, one for each of the shadow copy volumes. The consistency check is performed on these volumes.

[out, optional] ppAsync

A pointer to a variable that will receive an IWsbApplicationAsync interface pointer that can be used to retrieve the status of the consistency-check operation. This pointer can be NULL if a consistency check is not required. When the consistency-check operation is complete, the IUnknown::Release method must be called to free all resources held by the IWsbApplicationAsync object.

Return value

Returns S_OK if successful, or an error value otherwise. Possible return values include the following.

Remarks

The application should perform the consistency check as an asynchronous operation, because it might be a long-running operation. The application should check the consistency of the files for the VSS writer's components in the shadow copy. These files will be backed up as part of the backup operation. If the consistency check fails, the backup of the components will still succeed, but recovery of the components will not be allowed from the resulting backup set.

Requirements

See also

IWsbApplicationBackupSupport