次の方法で共有

IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths メソッド (vsbackup.h)

  • [アーティクル]

ローカル ボリューム パスまたは UNC 共有パスを正規化して、 IVssBackupComponents::AddToSnapshotSet メソッドに渡すことができます。

構文

HRESULT GetRootAndLogicalPrefixPaths(
  [in]           VSS_PWSZ pwszFilePath,
  [out]          VSS_PWSZ *ppwszRootPath,
  [out]          VSS_PWSZ *ppwszLogicalPrefix,
  [in, optional] BOOL     bNormalizeFQDNforRootPath
);

パラメーター

[in] pwszFilePath

正規化するパス。

[out] ppwszRootPath

IVssBackupComponents::AddToSnapshotSet メソッドに渡すルート パスを受け取ります。

[out] ppwszLogicalPrefix

pwszFilePath がローカル パスの場合、このパラメーターはボリューム GUID 名を受け取ります。 UNC パスの場合、このパラメーターは完全に評価された共有パスを受け取ります。

[in, optional] bNormalizeFQDNforRootPath

pwszFilePath が UNC 共有パスの場合、サーバー名の部分は

  • ホスト名
  • 完全修飾ドメイン名
  • IP アドレス

このパラメーターは、 ppwszRootPath パラメーターで返される正規化されたルート パスのサーバー名部分でホスト名形式または完全修飾ドメイン名形式を使用するかどうかを指定します。

このパラメーターが FALSE の場合は、単純なホスト名の形式が使用されます。

このパラメーターの既定値は、FALSE です。

このパラメーターが TRUE の場合は、完全修飾ドメイン名が使用されます。

ホスト名が複数のドメイン サフィックスに存在する可能性があるデプロイでは、このパラメーターは TRUE にする必要があります。

戻り値

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

リターン コード 説明
S_OK
 パス情報が正常に返されました。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。

解説

このメソッドは、ローカル ボリューム パスまたは UNC 共有パスを正規化し、ルート パスと論理プレフィックス パスに分離します。 その後、ルート パスを IVssBackupComponents::AddToSnapshotSet メソッドに渡すことができます。

pwszFilePath がローカル ボリューム パスの場合、ルート パスはボリューム マウント ポイントに似ています。 この場合、ルート パスと論理プレフィックス パスは、それぞれ GetVolumePathName と GetVolumeNameForVolumeMountPoint の結果にマップされます。

pwszFilePath が UNC 共有パスの場合、ルートと論理プレフィックスのパスは、それぞれファイル共有のルート パスと、完全に評価された物理共有パス (DFS とクラスターのデプロイを考慮) にマップされます。

同じシャドウ コピー セット作成操作に対してこのメソッドを複数回呼び出す場合は、呼び出しごとに bNormalizeFQDNforRootPath を同じ値に設定する必要があります。 完全修飾ドメイン名の形式とホスト名の形式を同じシャドウ コピー セットに混在させることはできません。

要件

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

関連項目

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4