IVssHardwareSnapshotProvider::AreLunsSupported-Methode (vsprov.h)

Artikel
03/03/2024

Die AreLunsSupported-Methode bestimmt, ob der Hardwareanbieter die Erstellung von Schattenkopien für alle LUNs unterstützt, die zum Volume beitragen. VSS ruft die AreLunsSupported-Methode für jedes Volume auf, das dem Schattenkopiersatz hinzugefügt wird. Vor dem Aufrufen dieser Methode bestimmt VSS die LUNs, die zum Volume beitragen.

Für ein bestimmtes Volume kann jede LUN nur einmal beitragen. Eine bestimmte LUN kann zu mehreren Volumes beitragen.

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

Syntax

HRESULT AreLunsSupported(
  [in]      LONG                lLunCount,
  [in]      LONG                lContext,
  [in]      VSS_PWSZ            *rgwszDevices,
  [in, out] VDS_LUN_INFORMATION *pLunInformation,
  [out]     BOOL                *pbIsSupported
);

Parameter

[in] lLunCount

Anzahl der LUNs, die zu diesem Schattenkopievolume beitragen.

[in] lContext

Schattenkopiekontext für die aktuelle Schattenkopie, die durch eine Bitmaske von Flags aus der _VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Enumeration aufgezählt wird. Wenn das VSS_VOLSNAP_ATTR_TRANSPORTABLE-Flag festgelegt ist, ist der Schattenkopiensatz transportierbar.

[in] rgwszDevices

Liste der Geräte, die den zu kopierenden LUNs entsprechen.

[in, out] pLunInformation

Array von lLunCountVDS_LUN_INFORMATION Strukturen, eine für jede LUN, die zu diesem Schattenkopievolume beiträgt.

[out] pbIsSupported

Zeiger auf einen BOOL-Wert . Wenn alle Geräte für die Schattenkopie unterstützt werden, sollte der Anbieter einen TRUE-Wert an der Position speichern, auf die von pbIsSupported verwiesen wird.

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	Ein unerwarteter Anbieterfehler ist aufgetreten. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden und dem Benutzer Informationen zum Beheben des Problems bereitstellen.

Hinweise

Wenn das Hardwaresubsystem die Richtlinien SCSI-Abfragedaten und wichtige Produktdaten seite 80 (Geräteseriennummer) und Seite 83 (Geräteidentität) unterstützt, muss der Anbieter die Strukturen im pLunInformation-Array nicht ändern.

In jedem Fall sollte die AreLunsSupported-Methode den Wert des m_rgInterconnects-Members einer VDS_LUN_INFORMATION Struktur im pLunInformation-Array nicht ändern.

Wenn der Anbieter die Erstellung von Hardwareschattenkopien für alle LUNs im pLunInformation-Array unterstützt, sollte er true im BOOL-Wert zurückgeben, auf den der pbIsSupported-Parameter verweist. Wenn der Anbieter keine Hardwareschattenkopien für eine oder mehrere LUNs unterstützt, muss er diesen BOOL-Wert auf FALSE festlegen.

Der Anbieter darf niemals zustimmen, Schattenkopien zu erstellen, wenn dies nicht möglich ist, auch wenn das Problem nur vorübergehend ist. Wenn eine vorübergehende Bedingung, z. B. niedrige Ressourcen, es dem Anbieter unmöglich macht, eine Schattenkopie mit einer oder mehreren LUNs zu erstellen, wenn AreLunsSupported aufgerufen wird, muss der Anbieter den BOOL-Wert auf FALSE 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

Weitere Informationen

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Freigeben über