IVssHardwareSnapshotProvider::GetTargetLuns-Methode (vsprov.h)
Die GetTargetLuns-Methode fordert den Hardwareanbieter auf, die VDS_LUN_INFORMATION Strukturen für die neu erstellten Schattenkopie-LUNs zu initialisieren. Die GetTargetLuns-Methode wird nach der IVssProviderCreateSnapshotSet::P ostCommitSnapshots-Methode aufgerufen. Identifizierende Informationen für jede neu erstellte LUN werden über VDS_LUN_INFORMATION-Strukturen an VSS zurückgegeben.
Syntax
HRESULT GetTargetLuns(
[in] LONG lLunCount,
[in] VSS_PWSZ *rgDeviceNames,
[in] VDS_LUN_INFORMATION *rgSourceLuns,
[in, out] VDS_LUN_INFORMATION *rgDestinationLuns
);
Parameter
[in] lLunCount
Anzahl der LUNs, die zum ursprünglichen Volume beitragen.
[in] rgDeviceNames
Zeiger auf ein Array von lLunCount-Zeigern auf Zeichenfolgen. Jede Zeichenfolge enthält den Namen einer ursprünglichen LUN, die schattenkopiert werden soll.
[in] rgSourceLuns
Zeiger auf ein Array von lLunCountVDS_LUN_INFORMATION Strukturen, eine für jede LUN, die zum ursprünglichen Volume beiträgt.
[in, out] rgDestinationLuns
Zeiger auf ein Array von lLunCountVDS_LUN_INFORMATION Strukturen, eines für jede neue Schattenkopie-LUN, die während der Verarbeitung von Schattenkopien erstellt wird. Zwischen den Elementen der Arrays rgSourceLuns und rgDestinationLuns sollte eine 1:1-Korrespondenz bestehen.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| 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
Im Parameter rgDestinationLuns stellt VSS eine leere VDS_LUN_INFORMATION-Struktur für jede neu erstellte Schattenkopie-LUN bereit. Die Schattenkopie-LUNs sind weder sichtbar noch für das System sichtbar. Der Anbieter sollte die Mitglieder der VDS_LUN_INFORMATION-Struktur mit den entsprechenden SCSI-Abfragedaten und vitalen Produktdaten auf Seite 80 (Geräteseriennummer) und Seite 83 (Geräteidentität) initialisieren. Die Struktur sollte die richtigen Memberwerte enthalten, sodass die Schattenkopie-LUNs von Windows vom ursprünglichen Computer oder von jedem anderen Computer, der mit dem SAN verbunden ist, gefunden werden können.
Die Elemente der VDS_LUN_INFORMATION Struktur entsprechen den Informationen der Seite 80, 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.
Die hier zurückgegebenen VDS_LUN_INFORMATION-Strukturen müssen mit den Strukturen übereinstimmen, die in der IVssHardwareSnapshotProvider::FillInLunInfo-Methode während des Imports bereitgestellt werden, damit VSS diese Informationen verwenden kann, um die neu ankommenden Schattenkopie-LUNs beim Import zu identifizieren. Dieselben Strukturen werden in der IVssHardwareSnapshotProvider::LocateLuns-Methode an den Anbieter übergeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsprov.h |