Método IVssHardwareSnapshotProvider::LocateLuns (vsprov.h)
El método LocateLuns solicita al proveedor de hardware que haga que los LUN de instantánea sean visibles para el equipo. VSS llama al método LocateLuns cuando se importa un conjunto de instantáneas de hardware a un equipo. El proveedor es responsable de cualquier desenmascarado (o "surfacing") en el nivel de hardware.
Sintaxis
HRESULT LocateLuns(
[in] LONG lLunCount,
[in] VDS_LUN_INFORMATION *rgSourceLuns
);
Parámetros
[in] lLunCount
Número de LUN que contribuyen a este conjunto de instantáneas.
[in] rgSourceLuns
Puntero a una matriz de estructuras de VDS_LUN_INFORMATION iLunCount, una para cada LUN que forma parte del conjunto de instantáneas que se va a importar.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se completó correctamente. |
|
Memoria insuficiente u otros recursos del sistema. |
|
Uno de los valores de parámetro no es válido. |
|
Error inesperado del proveedor. El proveedor debe notificar un evento en el registro de eventos de la aplicación que proporciona al usuario información sobre cómo resolver el problema. |
Comentarios
En el parámetro rgSourceLuns , VSS proporciona la misma matriz de estructuras de VDS_LUN_INFORMATION que el proveedor inicializó anteriormente en su método IVssHardwareSnapshotProvider::GetTargetLuns . Para cada estructura de VDS_LUN_INFORMATION de la matriz, el proveedor debe desenmascarar (o "superficie") el LUN de instantánea correspondiente al equipo.
Inmediatamente después de que este método vuelva, VSS realizará una nueva examen y enumeración para detectar los dispositivos llegados. Esto hace que el administrador de PnP detecte los LUN expuestos. En paralelo con la escucha de llegadas de disco, VSS también escuchará las llegadas de volumen ocultas. VSS dejará de escuchar después de que todos los volúmenes que contribuyan a un conjunto de instantáneas aparezcan en el sistema o se agote el tiempo de espera. Si algunos dispositivos de disco o volumen no aparecen en esta ventana, se indicará al solicitante que solo algunas de las instantáneas fueron importadas por VSS que devuelven VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED al solicitante. El solicitante también recibirá el mismo error de VSS si los VDS_LUN_INFORMATION estructuras recibidas de los métodos GetTargetLuns e IVssHardwareSnapshotProvider::FillInLunInfo no coinciden.
Este método no se puede usar para asignar LUN de instantáneas como de solo lectura.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsprov.h |