IVssWMFiledesc::GetBackupTypeMask method

The GetBackupTypeMask method returns the file backup specification for the files specified by the current file descriptor as a bit mask (or bitwise OR) of VSS_FILE_SPEC_BACKUP_TYPE values. This information indicates if the files are to be evaluated by their writer for participation in various specific types of backup operations (or if they will participate in an incremental or differential backups).

Syntax


HRESULT GetBackupTypeMask(
   DWORD *pdwTypeMask
);

Parameters

pdwTypeMask

Pointer to a DWORD containing a bit mask (or bitwise OR) of VSS_FILE_SPEC_BACKUP_TYPE values indicating the file backup specification for the file or file set described by the current IVssWMFiledesc interface.

Return value

The following are the valid return codes for this method.

ValueMeaning
S_OK

Successfully returned the filespec information.

E_INVALIDARG

The pdwTypeMask variable points to a NULL region of memory.

E_OUTOFMEMORY

The caller is out of memory or other system resources.

VSS_E_INVALID_XML_DOCUMENT

The XML document is not valid. Check the event log for details. For more information, see Event and Error Handling Under VSS.

VSS_E_UNEXPECTED

Unexpected error. The error code is logged in the error log file. For more information, see Event and Error Handling Under VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP:  This value is not supported until Windows Server 2008 R2 and Windows 7. E_UNEXPECTED is used instead.

 

Remarks

A file backup specification is specified by a writer when it adds a file specification to a component using the IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles, or IVssCreateWriterMetadata::AddDatabaseLogFiles method.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

VsWriter.h (include Vss.h or VsWriter.h)

Library

VssApi.lib

See also

IVssCreateWriterMetadata::AddDatabaseFiles
IVssCreateWriterMetadata::AddDatabaseLogFiles
IVssCreateWriterMetadata::AddFilesToFileGroup
IVssWMFiledesc
VSS_FILE_SPEC_BACKUP_TYPE

 

 

Show: