Subrutina HBA_OpenAdapterByWWN
Finalidad
Intenta abrir un manejador para el HBA que contiene un Nombre de nodo o N_Port_Name que coincide con el argumento wwn .
Sintaxis
HBA_STATUS HBA_OpenAdapterByWWN(
HBA_HANDLE *pHandle,
HBA_WWN wwn
);Descripción
La función HBA_OpenAdapterByWWN intenta abrir un handle al HBA que contenga un Node_Name o N_Port_Name que coincida con el argumento wwn. El Identificador_nombre especificado coincide con Nombre de nodo o N_Port_Name del HBA. Los puertos finales descubiertos (puertos de extremo remotos) son no seleccionados para una coincidencia.
Parámetros
| Elemento | Descripción |
|---|---|
| pHandle | Puntero a un descriptor de contexto. El valor de entrada es irrelevante. |
| WWN | Identificador_nombre para que se pueda abrir Nombre de nodo o N_Port_Name del HBA. |
Valores de retorno
El valor de la función HBA_OpenAdapterByWWN es un valor de retorno de estado válido que indica el motivo de la finalización de la función solicitada. HBA_STATUS_OK se devuelve para indicar que el descriptor de contexto contiene un manejador de HBA válido.
Los valores de retorno para el parámetro siguiente son los siguientes:
| Elemento | Descripción |
|---|---|
| pHandle | Permanece sin cambios. Si la apertura es satisfactoria, el valor al que apunta es un manejador para el HBA solicitado. En caso de anomalía, el valor no está definido. |
Códigos de error
| Elemento | Descripción |
|---|---|
| HBA_STATUS_ERROR_ILLEGAL_WWN | No hay ningún HBA con Nombre de nodo o N_Port_Name que coincida con wwn. |
| HBA_STATUS_ERROR_AMBIGUOUS_WWN | Varios HBA tienen una Identificador_nombrecoincidente. Esto puede ocurrir si los Nombre de nodode varios HBA son idénticos. |
| HBA_STATUS_ERROR | Se ha devuelto para indicar cualquier otro problema con la apertura del HBA. |