IVssBackupComponents::AddToSnapshotSet メソッド (vsbackup.h)

AddToSnapshotSet メソッドは、元のボリュームまたは元のリモート ファイル共有をシャドウ コピー セットに追加します。

構文

HRESULT AddToSnapshotSet(
  [in]  VSS_PWSZ pwszVolumeName,
  [in]  VSS_ID   ProviderId,
  [out] VSS_ID   *pidSnapshot
);

パラメーター

[in] pwszVolumeName

ボリュームの名前またはシャドウ コピーするリモート ファイル共有の UNC パスを含む Null で終わるワイド文字列。 名前または UNC パスは、次のいずれかの形式で指定し、末尾に円記号 (\) を含める必要があります。

• マウントされたフォルダーのパス (Y:\MountX\ など)
• ドライブ文字 (D:\ など)
• \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)
• リモート ファイル共有を指定する UNC パス (\\Clusterx\Share1\ など)

[in] ProviderId

使用するプロバイダー。 GUID_NULLを使用できます。この場合、既定のプロバイダーが使用されます。

[out] pidSnapshot

追加されたシャドウ コピーの識別子が返されました。

戻り値

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

注釈

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8してWindows Server 2012するまでサポートされません。

pwszVolumeName が UNC 共有パスの場合、サーバー名の部分はホスト名または完全修飾ドメイン名形式である必要があります。 IP アドレスを持つ UNC 共有名は、AddToSnapshotSet に渡される前に IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths メソッドを呼び出して正規化する必要があります。

1 つのシャドウ コピー セットでシャドウ コピーされるボリュームの最大数は 64 です。

ProviderId がGUID_NULL場合は、次のアルゴリズムに従って既定のプロバイダーが選択されます。

1. ハードウェア プロバイダーが特定のボリュームまたはリモート ファイル共有をサポートしている場合は、そのプロバイダーが選択されます。
2. 使用可能なハードウェア プロバイダーがない場合、ソフトウェア プロバイダーが特定のボリュームをサポートしている場合は、そのプロバイダーが選択されます。
3. 使用可能なハードウェア プロバイダーまたはソフトウェア プロバイダーがない場合は、システム プロバイダーが選択されます。 (プレインストールされているシステム プロバイダーは 1 つだけで、すべての非移動可能なローカル ボリュームをサポートする必要があります)。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: VHD はサポートされていません。

pidSnapshot パラメーターで返されるシャドウ コピー識別子は、バックアップ コンポーネント ドキュメントに格納されます。 ただし、この情報を照会する方法はなく、呼び出し元が復元中に使用できるように格納する必要がある場合があります。

要件

こちらもご覧ください

IVssBackupComponents

IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES