Metodo IVssHardwareSnapshotProvider::LocateLuns (vsprov.h)

Articolo
03/08/2023

Il metodo LocateLuns richiede al provider hardware di rendere visibili i LUN di copia shadow al computer. Il metodo LocateLuns viene chiamato da VSS quando un set di copie shadow hardware viene importato in un computer. Il provider è responsabile di qualsiasi maschera (o "surfacing") a livello di hardware.

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

Sintassi

HRESULT LocateLuns(
  [in] LONG                lLunCount,
  [in] VDS_LUN_INFORMATION *rgSourceLuns
);

Parametri

[in] lLunCount

Numero di LUN che contribuiscono a questo set di copie shadow.

[in] rgSourceLuns

Puntatore a una matrice di strutture iLunCountVDS_LUN_INFORMATION , una per ogni LUN che fa parte del set di copie shadow da importare.

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

Nel parametro rgSourceLuns , VSS fornisce la stessa matrice di strutture VDS_LUN_INFORMATION inizializzate in precedenza nel metodo IVssHardwareSnapshotProvider::GetTargetLuns . Per ogni VDS_LUN_INFORMATION struttura nella matrice, il provider deve annullare il mascheratura (o "superficie") il LUN della copia shadow corrispondente nel computer.

Subito dopo il ritorno di questo metodo, VSS eseguirà una nuova analisi e un'enumerazione per rilevare eventuali dispositivi arrivati. Ciò fa sì che eventuali LUN esposti vengano individuati dal gestore PnP. In parallelo con l'ascolto degli arrivi del disco, il Servizio Copia Shadow del volume rimane in ascolto anche per gli arrivi di volumi nascosti. Il servizio Copia Shadow del volume smette di essere in ascolto dopo che tutti i volumi che contribuiscono a un set di copie shadow vengono visualizzati nel sistema o si verifica un timeout. Se alcuni dispositivi disco o volume non vengono visualizzati in questa finestra, al richiedente verrà indicato che solo alcune delle copie shadow sono state importate dal Servizio Copia Shadow del volume restituendo VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED al richiedente. Il richiedente riceverà anche lo stesso errore dal Servizio Copia Shadow del database se le strutture VDS_LUN_INFORMATION ricevute dai metodi GetTargetLuns e IVssHardwareSnapshotProvider::FillInLunInfo non corrispondono.

Questo metodo non può essere usato per eseguire il mapping dei LUN di copia shadow come di sola lettura.

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

AreLunsSupported

FillInLunInfo

GetTargetLuns

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION

Condividi tramite