RemoveIscsiPersistentTarget function

The RemoveIscsiPersistentTarget function removes a persistent login for the specified hardware initiator Host Bus Adapter (HBA), initiator port, and target portal.

Syntax


HRESULT WINAPI RemoveIscsiPersistentTarget(
  _In_      PTCHAR InitiatorInstance,
  _In_opt_  ULONG InitiatorPortNumber,
  _In_      PTCHAR TargetName,
  _In_      PISCSI_TARGET_PORTAL Portal
);

Parameters

InitiatorInstance [in]

The name of the initiator that maintains the persistent login to remove.

InitiatorPortNumber [in, optional]

The port number on which the initiator connects to TargetName. If InitiatorPortNumber is ISCSI_ALL_INITIATOR_PORTS the miniport driver for the initiator HBA removes the TargetName from the persistent login lists for all initiator ports.

TargetName [in]

The name of the target.

Portal [in]

The portal through which the initiator connects to the target. If Portal is null or contains no information, the miniport driver for the initiator HBA removes persistent logins for the target on all portals.

Return value

Returns ERROR_SUCCESS if the operation succeeds. Otherwise, it returns the appropriate Win32 or iSCSI error code.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Iscsidsc.h

Library

Iscsidsc.lib

DLL

Iscsidsc.dll

Unicode and ANSI names

RemoveIscsiPersistentTargetW (Unicode) and RemoveIscsiPersistentTargetA (ANSI)

See also

AddPersistentIscsiDevice
ClearPersistentIscsiDevices
RemovePersistentIscsiDevice
ReportIscsiPersistentLogins
ReportPersistentIscsiDevices
SetupPersistentIscsiDevices

 

 

Community Additions

ADD
Show:
© 2014 Microsoft