Subrutina HBA_SendRLS

Editar en línea

Finalidad

Emite un servicio de enlace ampliado de estado de error de enlace de lectura (RLS) a través del puerto final de HBA especificado.

Sintaxis

HBA_STATUS HBA_SendRLS (
		HBA_HANDLE handle,
		HBA_WWN hbaPortWWN,
		HBA_WWN destWWN,
		void *pRspBuffer,
		HBA_UINT32 *pRspBufferSize,
);

Descripción

La función HBA_SendRLS emite un servicio de enlace extendido Read Link Error Status Block (RLS) a través del puerto final del HBA especificado para solicitar a un FC_Port remoto especificado que devuelva el bloque de estado de error de enlace asociado con el nombre del puerto de destino.

Parámetros

Elemento Descripción
descriptor de contexto Un manejador para un HBA abierto a través del cual se envía el ELS.
hbaPortWWN Puerto Nombre del puerto final de HBA local a través del cual se envía el ELS.
destWWN Puerto Nombre del FC_Port remoto al que se envía el ELS.
pRspBuffer Puntero a un almacenamiento intermedio para recibir la respuesta ELS.
pRSPBufferSize Puntero al tamaño en bytes de pRspBuffer. Un tamaño de 28 es suficiente para la respuesta más grande.

Valores de retorno

El valor de la función HBA_SendRLS es un valor de retorno de estado válido que indica la razón de finalización de la función solicitada. HBA_STATUS_OK se devuelve para indicar que se ha devuelto el LS_ACC completo al ELS de RLS. Se debe devolver un valor de retorno de estado válido que describa más de cerca el resultado de la función para indicar una razón sin valor necesario.

Los valores de retorno para los parámetros siguientes son los siguientes:

Elemento Descripción
pRspBuffer Permanece sin cambios. El almacenamiento intermedio al que apunta contiene los datos de carga útil de la respuesta RLS. Tenga en cuenta que si el ELS se ha rechazado, se trata de la carga útil LS_RJT. Si el tamaño de la carga útil de la respuesta supera el tamaño especificado en el parámetro pRspBufferSize al entrar en la función, los datos devueltos se truncan al tamaño especificado en el argumento.
pRspBufferSize Permanece sin cambios. El valor del entero al que apunta contiene el tamaño en bytes de la carga útil de respuesta ELS completa. Esto puede superar el tamaño especificado como argumento. Esto indica que los datos en pRspBuffer han sido truncados.

Códigos de error

Elemento Descripción
HBA_STATUS_ERROR_ELS_REJECT El ID de RNID ELS ha sido rechazado por el destino FC_Port.
HBA_STATUS_ERROR_ILLEGAL_WWN El HBA referenciado por handle no contiene un puerto final con Nombre de Puerto hbaPortWWN.
HBA_STATUS_ERROR Se ha devuelto para indicar cualquier problema sin ningún valor necesario.