IVssHardwareSnapshotProvider：：FillInLunInfo 方法 (vsprov.h)

發行項
03/09/2024

FillInLunInfo 方法會提示硬體提供者指出它是否支持對應的磁碟裝置，並更正VDS_LUN_INFORMATION結構中的任何遺漏。 VSS 會在 IVssHardwareSnapshotProvider：：LocateLuns 方法或 IVssHardwareSnapshotProvider：：OnLunEmpty 方法之前呼叫 FillInLunInfo 方法，以取得與陰影複製 LUN 相關聯的VDS_LUN_INFORMATION結構。 VSS 會比較 IVssHardwareSnapshotProvider：：GetTargetLuns 方法中所收到的VDS_LUN_INFORMATION結構，以識別陰影複製 LUN。如果結構不相符，要求者會收到 VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED，這表示不符。

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

語法

HRESULT FillInLunInfo(
  [in]      VSS_PWSZ            wszDeviceName,
  [in, out] VDS_LUN_INFORMATION *pLunInfo,
  [out]     BOOL                *pbIsSupported
);

參數

[in] wszDeviceName

對應至陰影複製 LUN 的裝置。

[in, out] pLunInfo

陰影複製 LUN 的 VDS_LUN_INFORMATION 結構。

[out] pbIsSupported

如果支持裝置，提供者必須在 pbIsSupported 參數指向的位置中傳回 TRUE。

傳回值

VSS 會忽略這個方法的傳回值。

Windows Server 2003： VSS 不會忽略傳回值，這可以是下列其中一個值。

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

備註

VSS 會針對提供者先前在其 GetTargetLuns 方法中初始化的每個VDS_LUN_INFORMATION結構呼叫 FillInLunInfo 方法。 VSS 也會針對匯入程式期間抵達系統的每個新磁碟裝置呼叫 FillInLunInfo 方法。

提供者可以更正 pLunInfo 參數中所收到VDS_LUN_INFORMATION結構中的任何遺漏。不過，提供者不應該修改這個結構 m_rgInterconnects 成員的值。

VDS_LUN_INFORMATION結構的成員會對應至 SCSI 查詢數據和重要產品數據頁面 80 (裝置序號) 資訊，但下列例外狀況：

m_version成員必須設定為 VER_VDS_LUN_INFORMATION。
匯入期間的比較會忽略 m_BusType 成員。此值取決於對應磁碟裝置上的 PnP 儲存堆疊。這通常是 VDSBusTypeScsi。
匯入期間的比較會忽略 m_diskSignature 成員。提供者必須將這個成員設定為 GUID_NULL。

VDS_LUN_INFORMATION結構) m_deviceIdDescriptor成員中的VDS_STORAGE_DEVICE_ID_DESCRIPTOR (結構成員) 對應至第 83 頁資訊。在此結構中，每個 VDS_STORAGE_IDENTIFIER 結構都會對應到裝置標識碼 (STORAGE_IDENTIFIER 結構，也就是關聯類型為零) 的記憶體標識碼。如需STORAGE_IDENTIFIER結構的詳細資訊，請參閱 Windows 驅動程式套件 (WDK) 檔。

如果針對提供者未知的 LUN 呼叫 FillInLunInfo 方法，提供者就不應該傳回錯誤。相反地，它應該會在 pbIsSupported 參數指向的 BOOL 值中傳回 FALSE，並傳回成功。如果提供者辨識 LUN，則應將 BOOL 值設定為 TRUE。

規格需求

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