IVssHardwareSnapshotProvider：：BeginPrepareSnapshot 方法 (vsprov.h)

  • 發行項

系統會針對新增至陰影複製集的每個陰影複製呼叫 BeginPrepareSnapshot 方法。

注意 只有 Windows Server 作業系統才支持硬體提供者。
 

語法

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

參數

[in] SnapshotSetId

陰影複製集標識碼。

[in] SnapshotId

要建立之陰影複製的標識碼。

[in] lContext

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES列舉目前陰影複製 集的陰影複製內容。

[in] lLunCount

參與此陰影複製磁碟區的 LUN 計數。

[in] rgDeviceNames

lLunCount 指標陣列的指標指向字串，每個字串都包含要陰影複製之 LUN 的名稱。

[in, out] rgLunInformation

lLunCountVDS_LUN_INFORMATION 結構的陣列指標，每個 LUN 各一個代表此陰影複製磁碟區。

傳回值

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

傳回碼/值 Description
S_OK
0x00000000L
 作業已順利完成。
E_OUTOFMEMORY
0x8007000EL
 記憶體不足或其他系統資源。
E_INVALIDARG
0x80070057L
 其中一個參數值無效。
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 提供者已達到可支援的最大磁碟區數目。
VSS_E_NESTED_VOLUME_LIMIT
 指定的磁碟區巢狀太深，無法參與 VSS 作業。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此傳回碼。
VSS_E_PROVIDER_VETO
0x80042306L
 發生非預期的提供者錯誤。 提供者必須在應用程式事件記錄檔中報告事件，為使用者提供如何解決問題的相關信息。
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 提供者不支援此磁碟區。
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
 不支援 lContext 所指定的內容。

備註

無法針對位於另一個 VHD 內巢狀的虛擬硬碟 (VHD) 呼叫這個方法。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援 VHD。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vsprov.h

另請參閱

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES