IVssCreateWriterMetadata::SetBackupSchema method (vswriter.h)
The SetBackupSchema method is used by a writer to indicate in its Writer Metadata Document the types of backup operations it can participate in.
HRESULT SetBackupSchema( [in] DWORD dwSchemaMask );
The types of backup operations this writer supports expressed as a bitmask of VSS_BACKUP_SCHEMA enumeration values.
For express writers, only the VSS_BS_UNDEFINED, VSS_BS_COPY, and VSS_BS_INDEPENDENT_SYSTEM_STATE values are supported.
The following are the valid return codes for this method.
||Successfully set the failure message.|
||The backup schema argument is not valid.|
||The caller is out of memory or other system resources.|
||The XML document is not valid. Check the event log for details. For more information, see Event and Error Handling Under VSS.|
||The caller specified a VSS_BACKUP_SCHEMA value that is not supported for express writers.|
If no schema is explicitly set by SetBackupSchema, the writer will be assigned the default value of VSS_BS_UNDEFINED: the writer supports only simple full backup and restoration of entire files (as defined by VSS_BT_FULL), there is no support for incremental or differential backups, and partial files are not supported.
Requesters call IVssExamineWriterMetadata::GetBackupSchema to retrieve a writer's backup schemas as set by SetBackupSchema.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|Header||vswriter.h (include Vss.h, VsWriter.h)|