Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
CreateMetadata Method
Collapse the table of content
Expand the table of content

IVssExpressWriter::CreateMetadata method

Creates an express writer metadata object and returns an IVssCreateExpressWriterMetadata interface pointer to it.

Syntax


HRESULT CreateMetadata(
  [in]  VSS_ID                     writerId,
  [in]  LPCWSTR                    writerName,
  [in]  VSS_USAGE_TYPE             usageType,
  [in]  DWORD                      versionMajor,
  [in]  DWORD                      versionMinor,
  [in]  DWORD                      reserved,
  [out] IVssCreateWriterMetadataEx **ppMetadata
);

Parameters

writerId [in]

The globally unique identifier (GUID) of the writer class.

writerName [in]

A null-terminated wide character string that contains the name of the writer class. This string is not localized.

usageType [in]

A VSS_USAGE_TYPE enumeration value that indicates how the data that is managed by the writer is used on the host system. The only valid values for this parameter are VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE, and VSS_UT_USERDATA.

versionMajor [in]

The major version of the writer application. For more information, see the Remarks section.

versionMinor [in]

The minor version of the writer application. For more information, see the Remarks section.

reserved [in]

This parameter is reserved for system use.

ppMetadata [out]

A pointer to a variable that receives an IVssCreateExpressWriterMetadata interface pointer to the newly created express writer metadata.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The versionMajor and versionMajor parameters are used to specify the writer's major and minor version numbers according to the following VSS conventions:

  • A writer's minor version number should be incremented by one whenever a released version of the writer contains minor changes that affect the writer's interaction with requesters. For example, a correction to a file specification in a writer QFE or service pack would justify incrementing the minor version number. However, a change between beta or release candidate versions of a writer would not justify the changing of the minor version number.
  • A writer's major version number should be incremented by one whenever a released version of the writer contains a significant change. For example, if data that is backed up with a new version of a writer cannot be restored using the previous version of the writer, the new writer's major version number should be incremented.
  • Whenever the major version number is incremented, the minor version number should be reset to zero.

If a writer does not specify a version number, VSS will assign a default version number of 0.0.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

VsWriter.h

See also

CreateVssExpressWriter
IVssExpressWriter

 

 

Community Additions

ADD
Show:
© 2015 Microsoft