IVssHardwareSnapshotProvider::LocateLuns-Methode (vsprov.h)
Die LocateLuns-Methode fordert den Hardwareanbieter auf, die Schattenkopie-LUNs für den Computer sichtbar zu machen. Die LocateLuns-Methode wird von VSS aufgerufen, wenn ein Hardwareschattenkopiesatz auf einen Computer importiert wird. Der Anbieter ist für alle Demaskierung (oder "Oberflächen") auf Hardwareebene verantwortlich.
Syntax
HRESULT LocateLuns(
[in] LONG lLunCount,
[in] VDS_LUN_INFORMATION *rgSourceLuns
);
Parameter
[in] lLunCount
Anzahl der LUNs, die zu diesem Schattenkopiersatz beitragen.
[in] rgSourceLuns
Zeiger auf ein Array von iLunCount-VDS_LUN_INFORMATION-Strukturen, eine für jede LUN, die Teil des zu importierenden Schattenkopiesatzes ist.
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. |
|
Unerwarteter Anbieterfehler. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden und dem Benutzer Informationen zum Beheben des Problems bereitstellen. |
Hinweise
Im rgSourceLuns-Parameter stellt VSS das gleiche Array von VDS_LUN_INFORMATION Strukturen bereit, das der Anbieter zuvor in seiner IVssHardwareSnapshotProvider::GetTargetLuns-Methode initialisiert hat. Für jede VDS_LUN_INFORMATION Struktur im Array sollte der Anbieter die entsprechende Schattenkopie-LUN auf dem Computer entlarven (oder "Surface").
Unmittelbar nach der Rückgabe dieser Methode führt VSS einen erneuten Scan und eine Enumeration durch, um alle eingetroffenen Geräte zu erkennen. Dadurch werden alle verfügbar gemachten LUNs vom PnP-Manager ermittelt. Parallel zum Lauschen auf Eintreffen von Datenträgern lauscht VSS auch auf ausgeblendete Volumeeingangsvorgänge. VSS hört nicht mehr zu, wenn alle Volumes, die zu einer Schattenkopie beitragen, im System angezeigt werden oder ein Timeout auftritt. Wenn einige Datenträger- oder Volumegeräte nicht in diesem Fenster angezeigt werden, wird der Anforderer darüber benachrichtigt, dass nur einige Schattenkopien von VSS importiert wurden, um VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED an den Anforderer zurückzugeben. Der Anforderer erhält auch denselben Fehler von VSS, wenn die von den Methoden GetTargetLuns und IVssHardwareSnapshotProvider::FillInLunInfo empfangenenVDS_LUN_INFORMATION Strukturen nicht übereinstimmen.
Diese Methode kann nicht verwendet werden, um Schattenkopie-LUNs als schreibgeschützt zuzuordnen.
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 |