CVssWriter：：GetSnapshotDeviceName 方法 (vswriter.h)

GetSnapshotDeviceName 方法會傳回裝載指定磁碟區或檔案共享陰影複製之裝置的名稱。 此方法可讓寫入器支援 自動復原 陰影複製，而且只能在 處理 OnPostSnapshot 方法期間呼叫。

語法

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

參數

[in] wszOriginalVolume

原始磁碟區的名稱或源檔共用的 UNC 路徑，其中包含用於目前陰影複製集的數據。 磁碟區的名稱必須是下列其中一種格式，而且必須包含尾端反斜杠 (\) ：

• 掛接資料夾的路徑，例如 Y：\MountX\
• 驅動器號，例如 D：\
• 格式為 \\？\Volume{GUID}\ 的磁碟區 GUID 路徑 (，其中 GUID 會識別磁碟區)
• 指定遠端檔案共用的 UNC 路徑，例如 \\Clusterx\Share1\

[out] ppwszSnapshotDevice

將接收陰影複製裝置名稱指標的 LPCWSTR 位址。

傳回值

這個方法可以傳回其中一個值。

值	意義
S_OK	已成功傳回陰影複製磁碟區名稱。
E_INVALIDARG	其中一個參數值無效。
VSS_E_BAD_STATE	在 PostSnapshot 事件期間未進行呼叫。
VSS_E_OBJECT_NOT_FOUND	wszOriginalVolume 參數不是陰影複製集中的其中一個磁碟區或檔案共用。

備註

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP 和 Windows Server 2003： 在 Windows 8 和 Windows Server 2012 之前，不支援遠端檔案共用。

若要取得 wszOriginalVolume 參數的原始磁碟區名稱，請先呼叫 CVssWriter：：GetCurrentVolumeCount 方法，以查詢陰影複製集中的磁碟區數目。 然後呼叫 CVssWriter：：GetCurrentVolumeArray 方法來列舉陰影複製集中磁碟區的原始名稱。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008、Windows Server 2003 SP1 [僅限桌面應用程式]
目標平台	Windows
標頭	vswriter.h (包括 Vss.h、VsWriter.h)
程式庫	VssApi.lib