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 にリセットする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vswriter.h |