IVssHardwareSnapshotProvider::LocateLuns 方法 (vsprov.h)

LocateLuns 方法會提示硬體提供者讓電腦看見陰影複製 LUN。 當硬體陰影複製集匯入計算機時,VSS 會呼叫 LocateLuns 方法。 提供者負責硬體層級的任何未遮罩 (或「呈現」) 。

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

語法

HRESULT LocateLuns(
  [in] LONG                lLunCount,
  [in] VDS_LUN_INFORMATION *rgSourceLuns
);

參數

[in] lLunCount

參與此陰影複製集的 LUN 數目。

[in] rgSourceLuns

iLunCountVDS_LUN_INFORMATION 結構的陣列指標,每個 LUN 各有一個 LUN 屬於要匯入的陰影複製集。

傳回值

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

傳回碼/值 Description
S_OK
0x00000000L
作業已順利完成。
E_OUTOFMEMORY
0x8007000EL
記憶體不足或其他系統資源。
E_INVALIDARG
0x80070057L
其中一個參數值無效。
VSS_E_PROVIDER_VETO
0x80042306L
發生非預期的提供者錯誤。 提供者必須在應用程式事件記錄檔中報告事件,為使用者提供如何解決問題的資訊。

備註

rgSourceLuns 參數中,VSS 會提供先前在其 IVssHardwareSnapshotProvider::GetTargetLuns 方法中初始化的相同VDS_LUN_INFORMATION結構數位。 針對陣列中的每個 VDS_LUN_INFORMATION 結構,提供者應該將對應的陰影複製 LUN 解除遮罩 (或「surface」) 。

在此方法傳回之後,VSS 會執行重新掃描和列舉來偵測任何抵達的裝置。 這會導致 PnP 管理員探索到任何公開的 LUN。 與接聽磁碟抵達平行,VSS也會接聽隱藏的磁碟區抵達。 VSS 將會停止接聽所有參與陰影複製集的磁碟區出現在系統中,或發生逾時。 如果某些磁碟或磁碟區裝置無法出現在此視窗中,則會告知要求者,VSS 只會匯入部分陰影複製,並傳回 VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED 給要求者。 如果從 GetTargetLunsIVssHardwareSnapshotProvider::FillInLunInfo 方法收到的VDS_LUN_INFORMATION結構,要求者也會收到相同的錯誤。

這個方法無法用來將陰影複製 LUN 對應為唯讀。

規格需求

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

另請參閱

AreLunsSupported

FillInLunInfo

GetTargetLuns

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION