Metodo IVssHardwareSnapshotProvider::GetTargetLuns (vsprov.h)

  • Articolo

Il metodo GetTargetLuns richiede al provider hardware di inizializzare le strutture di VDS_LUN_INFORMATION per le LUN di copia shadow appena create. Il metodo GetTargetLuns viene chiamato dopo il metodo IVssProviderCreateSnapshotSet::P ostCommitSnapshots . L'identificazione delle informazioni per ogni LUN appena creata viene restituita a VSS tramite VDS_LUN_INFORMATION strutture.

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

Sintassi

HRESULT GetTargetLuns(
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in]      VDS_LUN_INFORMATION *rgSourceLuns,
  [in, out] VDS_LUN_INFORMATION *rgDestinationLuns
);

Parametri

[in] lLunCount

Numero di LUN che contribuiscono al volume originale.

[in] rgDeviceNames

Puntatore a una matrice di puntatori lLunCount alle stringhe. Ogni stringa contiene il nome di un LUN originale da copiare.

[in] rgSourceLuns

Puntatore a una matrice di strutture VDS_LUN_INFORMATION lLunCount, una per ogni LUN che contribuisce al volume originale.

[in, out] rgDestinationLuns

Puntatore a una matrice di strutture VDS_LUN_INFORMATION lLunCount, una per ogni nuovo LUN di copia shadow creata durante l'elaborazione della copia shadow. Dovrebbe essere presente una corrispondenza uno-a-uno tra gli elementi delle matrici rgSourceLuns e rgDestinationLuns .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito Descrizione
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 del provider imprevisto. Il provider deve segnalare un evento nel registro eventi dell'applicazione che fornisce all'utente informazioni su come risolvere il problema.

Commenti

Nel parametro rgDestinationLuns , VSS fornisce una struttura di VDS_LUN_INFORMATION vuota per ogni lun di copia shadow appena creata. Le LUN di copia shadow non sono visibili o visibile al sistema. Il provider deve inizializzare i membri della struttura VDS_LUN_INFORMATION con le informazioni appropriate relative ai dati dell'indagine SCSI e alla pagina 80 (numero di serie del dispositivo) e alla pagina 83 (identità del dispositivo). La struttura deve contenere valori membro corretti, in modo che le LUN di copia shadow possano essere posizionate da Windows dal computer originale o da qualsiasi altro computer connesso alla SAN.

I membri della struttura VDS_LUN_INFORMATION corrispondono alle informazioni della pagina 80, con le eccezioni seguenti:

  • Il membro m_version deve essere impostato su VER_VDS_LUN_INFORMATION.
  • Il membro m_BusType viene ignorato nei confronti durante l'importazione. Questo valore dipende dallo stack di archiviazione PnP nel dispositivo disco corrispondente. In genere si tratta di VDSBusTypeScsi.
  • Il membro m_diskSignature viene ignorato nei confronti durante l'importazione. Il provider deve impostare questo membro su GUID_NULL.
I membri della struttura VDS_STORAGE_DEVICE_ID_DESCRIPTOR (nel membro m_deviceIdDescriptor della strutturaVDS_LUN_INFORMATION) corrispondono alle informazioni della pagina 83. In questa struttura ogni struttura VDS_STORAGE_IDENTIFIER corrisponde alla struttura STORAGE_IDENTIFIER per un identificatore del dispositivo, ovvero un identificatore di archiviazione con un tipo di associazione pari a zero. Per altre informazioni sulla struttura STORAGE_IDENTIFIER, vedere la documentazione di Windows Driver Kit (WDK).

Le strutture VDS_LUN_INFORMATION restituite qui devono essere uguali alle strutture fornite nel metodo IVssHardwareSnapshotProvider::FillInLunInfo durante l'importazione in modo che VSS possa usare queste informazioni per identificare i LUN copia shadow appena in arrivo all'importazione. Queste stesse strutture verranno passate al provider nel metodo IVssHardwareSnapshotProvider::LocateLuns .

Requisiti

   
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