IVssHardwareSnapshotProvider::FillInLunInfo-Methode (vsprov.h)
Die FillInLunInfo-Methode fordert den Hardwareanbieter auf, anzugeben, ob er das entsprechende Datenträgergerät unterstützt, und alle Auslassungen in der VDS_LUN_INFORMATION-Struktur zu korrigieren. VSS ruft die FillInLunInfo-Methode nach der IVssHardwareSnapshotProvider::LocateLuns-Methode oder vor der IVssHardwareSnapshotProvider::OnLunEmpty-Methode auf, um die VDS_LUN_INFORMATION Struktur abzurufen, die einer Schattenkopie-LUN zugeordnet ist. VSS vergleicht die VDS_LUN_INFORMATION-Struktur , die in der IVssHardwareSnapshotProvider::GetTargetLuns-Methode empfangen wurde, um Schattenkopie-LUNs zu identifizieren. Wenn die Strukturen nicht übereinstimmen, erhält der Anforderer VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED, was auf eine Nichtübereinstimmung hinweist.
Syntax
HRESULT FillInLunInfo(
[in] VSS_PWSZ wszDeviceName,
[in, out] VDS_LUN_INFORMATION *pLunInfo,
[out] BOOL *pbIsSupported
);
Parameter
[in] wszDeviceName
Gerät, das der Schattenkopie-LUN entspricht.
[in, out] pLunInfo
Die VDS_LUN_INFORMATION-Struktur für die Schattenkopie-LUN.
[out] pbIsSupported
Der Anbieter muss TRUE an dem Speicherort zurückgeben, auf den der pbIsSupported-Parameter verweist, wenn das Gerät unterstützt wird.
Rückgabewert
VSS ignoriert den Rückgabewert dieser Methode.
Windows Server 2003: VSS ignoriert nicht den Rückgabewert, der einer der folgenden Werte sein kann.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Einer der Parameterwerte ist ungültig. |
|
Ein unerwarteter Anbieterfehler ist aufgetreten. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden und dem Benutzer Informationen zum Beheben des Problems bereitstellen. |
Hinweise
VSS ruft die FillInLunInfo-Methode für jede VDS_LUN_INFORMATION-Struktur auf, die der Anbieter zuvor in seiner GetTargetLuns-Methode initialisiert hat. VSS ruft auch die FillInLunInfo-Methode für jedes neue Datenträgergerät auf, das während des Importvorgangs im System eingeht.
Der Anbieter kann alle Auslassungen in der VDS_LUN_INFORMATION Struktur korrigieren, die im pLunInfo-Parameter empfangen wurde. Der Anbieter sollte jedoch den Wert des m_rgInterconnects Members dieser Struktur nicht ändern.
Die Elemente der VDS_LUN_INFORMATION Struktur entsprechen den Informationen zu SCSI-Abfragedaten und vitalen Produktdaten der Seite 80 (Geräteseriennummer) mit den folgenden Ausnahmen:
- Das m_version-Element muss auf VER_VDS_LUN_INFORMATION festgelegt werden.
- Das m_BusType-Member wird beim Import in Vergleichen ignoriert. Dieser Wert hängt vom PnP-Speicherstapel auf dem entsprechenden Datenträgergerät ab. In der Regel ist dies VDSBusTypeScsi.
- Das m_diskSignature-Member wird beim Import in Vergleichen ignoriert. Der Anbieter muss diesen Member auf GUID_NULL festlegen.
Wenn die FillInLunInfo-Methode für eine LUN aufgerufen wird, die dem Anbieter unbekannt ist, sollte der Anbieter keinen Fehler zurückgeben. Stattdessen sollte false im BOOL-Wert zurückgegeben werden, auf den der pbIsSupported-Parameter verweist und den Erfolg zurückgibt. Wenn der Anbieter die LUN erkennt, sollte er den BOOL-Wert auf TRUE festlegen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsprov.h |