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

HBA_OpenAdapter

HBA_STATUS

 

 

Send comments about this topic to Microsoft