Share via


HBA_RemoveAllPersistentBindings routine

The HBA_RemoveAllPersistentBindings routine removes all persistent bindings for a specified HBA port.

Syntax

HBA_STATUS HBA_API HBA_RemoveAllPersistentBindings(
  _In_ HBA_HANDLE Handle,
  _In_ HBA_WWN    HbaPortWWN
);

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.

Return value

The HBA_RemoveAllPersistentBindings routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_RemoveAllPersistentBindings returns one of the following values.

Return code Description
HBA_STATUS_OK

Returned if all 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