Freigeben über


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.

Hinweis Hardwareanbieter werden nur unter Windows Server-Betriebssystemen unterstützt.
 

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
S_OK
0x00000000L
Der Vorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
0x8007000EL
Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
E_INVALIDARG
0x80070057L
Einer der Parameterwerte ist ungültig.
VSS_E_PROVIDER_VETO
0x80042306L
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

Weitere Informationen

AreLunsSupported

FillInLunInfo

GetTargetLuns

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION