Función ReportActiveIScsiTargetMappingsA (iscsidsc.h)
función reportActiveIscsiTargetMappings recupera las asignaciones de destino que están activas actualmente para todos los iniciadores del equipo.
Sintaxis
ISDSC_STATUS ISDSC_API ReportActiveIScsiTargetMappingsA(
[in, out] PULONG BufferSize,
[out] PULONG MappingCount,
[out] PISCSI_TARGET_MAPPINGA Mappings
);
Parámetros
[in, out] BufferSize
Puntero a una ubicación a la que, en la entrada, contiene el tamaño, en bytes, del búfer al que asignaciones apunta. Si la operación se realiza correctamente, la ubicación recibe el tamaño, en bytes, de los datos de asignación recuperados. Si el búfer al que asignaciones apunta a no es suficiente para contener los datos de salida, la ubicación recibe el tamaño del búfer, en bytes, que es necesario.
[out] MappingCount
Si la operación se realiza correctamente, la ubicación a la que apunta MappingCount recibe el número de asignaciones que se recuperaron.
[out] Mappings
Un puntero a una matriz de tipo ISCSI_TARGET_MAPPING que, en la salida, se rellena con las asignaciones de destino activas para todos los iniciadores.
Valor devuelto
Devuelve ERROR_SUCCESS si la operación se realiza correctamente y ERROR_INSUFFICIENT_BUFFER si el búfer no es lo suficientemente grande.
De lo contrario, reportActiveIscsiTargetMappings devuelve el código de error de Win32 o iSCSI adecuado en caso de error.
Observaciones
Las asignaciones de destino asocian números de bus, destino y LUN a los LUN en un dispositivo de destino.
Nota
El encabezado iscsidsc.h define ReportActiveIScsiTargetMappings como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
iscsidsc.h |
| biblioteca de |
Iscsidsc.lib |
| DLL de |
Iscsidsc.dll |