HBA_RemovePersistentBinding routine
The HBA_RemovePersistentBinding routine retrieves information about the specified target.
Syntax
HBA_STATUS HBA_API HBA_RemovePersistentBinding(
_In_ HBA_HANDLE Handle,
_In_ HBA_WWN HbaPortWWN,
_In_ PHBA_FCPBINDING2 Binding
);
Parameters
Handle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA on which the port is located.HbaPortWWN [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies the local HBA port for which to remove all persistent bindings. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.Binding [in]
Contains a structure of type HBA_FCPBinding2 that contains an array of bindings between operating system identifiers, SCSI logical unit ID descriptors (LUIDs) and fibre channel protocol (FCP) identifiers for a set of logical units.
Return value
The HBA_RemovePersistentBinding routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_RemovePersistentBinding returns one of the following values.
| Return code | Description |
|---|---|
| HBA_STATUS_OK | Returned if the indicated persistent bindings were successfully removed for the indicated port. |
| 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_NOT_SUPPORTED | Returned if the HBA referenced by handle does not support persistent bindings. |
| HBA_STATUS_ERROR | Returned if an unspecified error occurred that prevented the removal of the persistent bindings. |
Remarks
The removal of persistent bindings does not change target mappings until the operating system is restarted or HBA and/or fabric is reinitialized.
Requirements
Target platform |
Desktop |
Header |
Hbaapi.h (include Hbaapi.h) |
Library |
Hbaapi.lib |
DLL |
Hbaapi.dll |
See also