次の方法で共有

IVssCreateExpressWriterMetadata::AddFilesToFileGroup メソッド (vswriter.h)

  • [アーティクル]

高速ライターの指定したファイル グループ コンポーネントにファイル セット (指定したファイル) を追加します。

構文

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

パラメーター

[in] wszLogicalPath

ファイル を追加するコンポーネントの論理パス (NULL である可能性があります) を含む null で終わるワイド文字列へのポインター。 詳細については、「 コンポーネントの論理パス」を参照してください。

[in] wszGroupName

ファイル グループ コンポーネントの名前を含む null で終わるワイド文字列へのポインター。 このコンポーネントの型はVSS_CT_FILEGROUPする必要があります。それ以外の場合、メソッドはエラーを返します。

[in] wszPath

追加するファイルの既定のルート ディレクトリを含む null で終わるワイド文字列へのポインター。

パスには環境変数 (%SystemRoot%) を含めることができますが、ワイルドカード文字を含めることはできません。

パスが円記号 (\) で終わるという要件はありません。 この情報をチェックに取得するのはアプリケーションです。

[in] wszFilespec

含めるファイルのファイル指定を含む null で終わるワイド文字列へのポインター。

ファイル指定にディレクトリ指定を含めることはできません (たとえば、円記号は含めません)。ただし、 を含めることができます。 および * ワイルドカード文字。

[in] bRecursive

wszPath パラメーターで指定されたパスが 1 つのディレクトリのみを識別するか、再帰的に走査するディレクトリの階層を示すかどうかを指定するブール値。 パスが繰り返されるディレクトリの階層として扱われる場合は true 、それ以外の場合は false に設定する必要があります。

マウントされたフォルダーの走査の詳細については、「マウント されたフォルダーの操作」および「ポイントの再解析」を参照してください。

[in] wszAlternateLocation

このパラメーターは予約済みであり、 NULL である必要があります。

[in] dwBackupTypeMask

ライターが特定の種類のバックアップ操作に参加するためにファイルを評価する必要があるかどうかを示す、 VSS_FILE_SPEC_BACKUP_TYPE 列挙値のビットマスク。

このパラメーターには、 VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED、 VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED、 またはVSS_FSBT_LOG_BACKUP_REQUIREDを含めることはできません。

この引数の既定値は (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED)。

戻り値

このメソッドの有効なリターン コードを次に示します。

値 説明
S_OK
 操作に成功しました。
E_INVALIDARG
 パラメーター値の 1 つが無効であるか、呼び出し元がファイル グループ以外のコンポーネントにファイル グループ ファイルを追加しようとしました。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_OBJECT_NOT_FOUND
 指定されたコンポーネントが存在しません。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vswriter.h (Vss.h、VsWriter.h を含む)
Library VssApi.lib

関連項目

IVssCreateExpressWriterMetadata