Condividi tramite


Metodo IVssHardwareSnapshotProvider::AreLunsSupported (vsprov.h)

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 ombra.

[in, out] pLunInformation

Matrice di struttureVDS_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 Description
S_OK
0x00000000L
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.

Osservazioni:

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, deve 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 basse, rende impossibile al 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 Value
Client minimo supportato Nessuna supportata
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Header vsprov.h

Vedere anche

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES