Compartir a través de

Método IVdsLunIscsi::AssociateTargets (vdshwprv.h)

  • Artículo

[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.]

Asocia LUN con destinos iSCSI del subsistema.

Sintaxis

HRESULT AssociateTargets(
  [in] VDS_OBJECT_ID *pTargetIdArray,
  [in] LONG          lNumberOfTargets
);

Parámetros

[in] pTargetIdArray

Puntero a una matriz de tipos de datos de destino VDS_OBJECT_ID . El proveedor asocia estos destinos iSCSI con el LUN. Esta matriz incluye destinos ya asociados al LUN que deben permanecer así.

[in] lNumberOfTargets

Número de destinos especificados en el parámetro pTargetArray .

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 se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código o valor devuelto Descripción
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Este valor devuelto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre la matriz. Use 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 un 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 o operaciones anteriores.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Se puede devolver desde cualquier método que tome una constante VDS_OBJECT_ID . Este valor devuelto indica que el identificador no hace referencia a un objeto existente.
VDS_E_NOT_SUPPORTED
0x80042400L
 Este proveedor no admite esta operación o combinación de parámetros.

Comentarios

La mayoría de los subsistemas implementan solo un destino asociado por LUN, pero algunos permiten varios destinos asociados.

Use el método IVdsLunIscsi::QueryAssociatedTargets para consultar las asociaciones de destino. Use el método IVdsIscsiTarget::QueryAssociatedLuns para consultar los LUN asociados a un destino.

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 vdshwprv.h
Redistribuible VDS 1.1

Consulte también

IVdsLunIscsi

IVdsLunIscsi::QueryAssociatedTargets