Método IVdsLunMpio::GetPathInfo (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Devuelve una matriz de estructuras de VDS_PATH_INFO , una para cada ruta de acceso al LUN.

Sintaxis

HRESULT GetPathInfo(
  [out] VDS_PATH_INFO **ppPaths,
  [out] LONG          *plNumberOfPaths
);

Parámetros

[out] ppPaths

Dirección de una variable que recibe una matriz de estructuras de VDS_PATH_INFO . Los autores de llamadas deben liberar cada elemento de la matriz y la propia matriz mediante la función CoTaskMemFree .

[out] plNumberOfPaths

Dirección de una variable que recibe el número de elementos de la matriz devuelta en el parámetro ppPaths .

El número de rutas de acceso devueltas por este método coincidirá con el número de rutas de acceso devueltas por el método IVdsLunMpio::GetLoadBalancePolicy .

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto	Descripción
S_OK	La información de ruta de acceso se devolvió correctamente.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	La memoria caché del proveedor está dañada. Esto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre los dispositivos conectados. El autor de la llamada puede usar el método IVdsHwProvider::Reenumerate seguido del método IVdsHwProvider::Refresh para restaurar la memoria caché.
VDS_E_OBJECT_DELETED 0x8004240BL	El objeto LUN ya no está presente.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	El LUN está en estado de error y no puede realizar la operación solicitada.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Otra operación está en curso. Esta operación no puede continuar hasta que se completen las operaciones anteriores.

Comentarios

Los proveedores de hardware no necesitan devolver el VDS_OBJECT_ID en hbaPortProp.id de VDS_PATH_INFO y solo deben establecerlo en GUID_NULL. El sistema rellenará este identificador cuando se devuelva esta llamada a las aplicaciones. Si el servicio no encuentra el puerto HBA correspondiente, se usará GUID_NULL . La aplicación interpretará esto para significar que el puerto HBA es desconocido para VDS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vds.h
Library	Uuid.lib
Redistribuible	VDS 1.1

Consulte también

IVdsLunMpio

VDS_PATH_INFO