IVssExpressWriter::CreateMetadata メソッド (vswriter.h)

高速ライター メタデータ オブジェクトを作成し、それに対する IVssCreateExpressWriterMetadata インターフェイス ポインターを返します。

構文

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

パラメーター

[in] writerId

ライター クラスのグローバル一意識別子 (GUID)。

[in] writerName

ライター クラスの名前を含む null で終わるワイド文字列。 この文字列はローカライズされていません。

[in] usageType

ライターによって管理されるデータがホスト システムでどのように使用されるかを示す VSS_USAGE_TYPE列挙値 。 このパラメーターの有効な値は、VSS_UT_BOOTABLESYSTEMSTATE、VSS_UT_SYSTEMSERVICE、VSS_UT_USERDATAのみです。

[in] versionMajor

ライター アプリケーションのメジャー バージョン。 詳細については、「解説」を参照してください。

[in] versionMinor

ライター アプリケーションのマイナー バージョン。 詳細については、「解説」を参照してください。

[in] reserved

このパラメーターは、システムで使用するために予約されています。

[out] ppMetadata

新しく作成された高速ライター メタデータへの IVssCreateExpressWriterMetadata インターフェイス ポインターを受け取る変数へのポインター。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

versionMajor パラメーターと versionMajor パラメーターは、次の VSS 規則に従ってライターのメジャー バージョン番号とマイナー バージョン番号を指定するために使用されます。

• ライターのマイナー バージョン番号は、ライターのリリース バージョンに、ライターと要求元との対話に影響を与える軽微な変更が含まれるたびに 1 ずつインクリメントする必要があります。 たとえば、ライター QFE または Service Pack のファイル仕様を修正すると、マイナー バージョン番号のインクリメントが正当化されます。 ただし、ライターのベータ版またはリリース候補バージョン間の変更は、マイナー バージョン番号の変更を正当化しません。
• ライターのメジャー バージョン番号は、リリースされたバージョンのライターに大幅な変更が含まれるたびに 1 ずつインクリメントする必要があります。 たとえば、新しいバージョンのライターでバックアップされたデータを以前のバージョンのライターを使用して復元できない場合は、新しいライターのメジャー バージョン番号をインクリメントする必要があります。
• メジャー バージョン番号がインクリメントされるたびに、マイナー バージョン番号を 0 にリセットする必要があります。

要件

こちらもご覧ください

CreateVssExpressWriter

IVssExpressWriter