HBA_SendSRL routine
The HBA_SendSRL routine issues a scan remote loop (SRL) request through the specified HBA to a specified domain controller.
Syntax
HBA_STATUS HBA_API HBA_SendSRL(
_In_ HBA_HANDLE handle,
_In_ HBA_WWN hbaPortWWN,
_In_ HBA_WWN wwn,
_In_ HBA_UINT32 domain,
_Out_ void *pRspBuffer,
_Inout_ HBA_UINT32 *pRspBufferSize
);
Parameters
handle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA through which the request is sent.hbaPortWWN [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies the port through which the SRL request is sent. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.wwn [in]
Contains a 64-bit WWN that uniquely identifies the FL_Port port that is associated with the loop that is scanned. The SRL request is sent to this port. If this member is NULL, it is ignored, and the SRL request is sent to the domain controller that is associated with the loop. The domain controller is identified by the value in domain.domain [in]
Indicates the number of the domain controller associated with the loops to scan. If wwn is nonzero, this member is ignored.pRspBuffer [out]
Pointer to a buffer that receives the output data of the SRL request.pRspBufferSize [in, out]
On input, indicates the size, in bytes, of the buffer at pRspBuffer. On output, this member contains the number of bytes of data retrieved in pRspBuffer. If the buffer is not large enough to receive all of the response data, the data is truncated to the size of the buffer. Eight bytes is sufficient buffer space for any response.
Return value
The HBA_SendSRL routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_SendSRL returns one of the following values.
| Return code | Description |
|---|---|
| HBA_STATUS_OK | Returned if the complete payload of a reply to the SRL request was successfully retrieved. |
| HBA_STATUS_ERROR_ILLEGAL_WWN | Returned if the HBA referenced by handle does not contain a port with a name that matches hbaPortWWN. |
| HBA_STATUS_ERROR_ELS_REJECT | Returned if the destination port referenced by wwn, or the domain controller referenced by domain, rejected the request node identification information data (RNID) that identifies the source HBA. |
| HBA_STATUS_ERROR | Returned if an unspecified error occurred that prevented the execution of the SRL request. |
Requirements
Target platform |
Desktop |
Header |
Hbaapi.h (include Hbaapi.h) |
Library |
Hbaapi.lib |
DLL |
Hbaapi.dll |
See also