Metodo IVssHardwareSnapshotProvider::AreLunsSupported (vsprov.h)

Articolo
03/09/2024

Il metodo AreLunsSupported determina se il provider hardware supporta la creazione di copie shadow per tutti i LUN che contribuiscono al volume. VSS chiama il metodo AreLunsSupported per ogni volume aggiunto al set di copie shadow. Prima di chiamare questo metodo, VSS determina i LUN che contribuiscono al volume.

Per un volume specifico, ogni LUN può contribuire una sola volta. Un LUN specifico può contribuire a più volumi.

Nota I provider hardware sono supportati solo nei sistemi operativi Windows Server.

Sintassi

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

Parametri

[in] lLunCount

Numero di LUN che contribuiscono a questo volume di copia shadow.

[in] lContext

Contesto di copia shadow per il set di copia shadow corrente come enumerato da una maschera di bit di flag dall'enumerazione _VSS_VOLUME_SNAPSHOT_ATTRIBUTES . Se il flag VSS_VOLSNAP_ATTR_TRANSPORTABLE è impostato, il set di copie shadow è trasportabile.

[in] rgwszDevices

Elenco di dispositivi corrispondenti ai LUN da copiare in ombreggiatura.

[in, out] pLunInformation

Matrice di strutture VDS_LUN_INFORMATION lLunCount, una per ogni LUN che contribuisce a questo volume di copia shadow.

[out] pbIsSupported

Puntatore a un valore BOOL . Se tutti i dispositivi sono supportati per la copia shadow, il provider deve archiviare un valore TRUE nella posizione a cui punta pbIsSupported.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0x0000000L	L'operazione è stata completata correttamente.
E_OUTOFMEMORY 0x8007000EL	Memoria insufficiente o altre risorse di sistema.
E_INVALIDARG 0x80070057L	Uno dei valori dei parametri non è valido.
VSS_E_PROVIDER_VETO 0x80042306L	Si è verificato un errore imprevisto del provider. Il provider deve segnalare un evento nel registro eventi dell'applicazione, fornendo all'utente informazioni su come risolvere il problema.

Commenti

Se il sottosistema hardware supporta le linee guida SCSI Inquiry Data e Vital Product Data page 80 (numero di serie del dispositivo) e pagina 83 (identità del dispositivo), il provider non deve modificare le strutture nella matrice pLunInformation .

In ogni caso, il metodo AreLunsSupported non deve modificare il valore del membro m_rgInterconnects di qualsiasi struttura VDS_LUN_INFORMATION nella matrice pLunInformation .

Se il provider supporta la creazione di copie shadow hardware per tutti i LUN nella matrice pLunInformation , deve restituire TRUE nel valore BOOL a cui punta il parametro pbIsSupported . Se il provider non supporta copie shadow hardware per uno o più LUN, è necessario impostare questo valore BOOL su FALSE.

Il provider non deve mai accettare di creare copie shadow se non riesce, anche se il problema è solo temporaneo. Se una condizione temporanea, ad esempio risorse ridotte, rende impossibile per il provider creare una copia shadow usando uno o più LUN quando viene chiamato AreLunsSupported , il provider deve impostare il valore BOOL su FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsprov.h

Vedi anche

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Condividi tramite