ReportIscsiTargetPortals function

The ReportIscsiTargetPortals function retrieves target portal information discovered by the iSCSI initiator service.

Syntax


HRESULT WINAPI ReportIscsiTargetPortals(
  _In_opt_ PWCHAR                InitiatorName,
  _In_     PWCHAR                TargetName,
  _In_opt_ PUSHORT               TargetPortalTag,
  _Inout_  PULONG                ElementCount,
  _Out_    PISCSI_TARGET_PORTALW Portals
);

Parameters

InitiatorName [in, optional]

A string that represents the name of the initiator node.

TargetName [in]

A string that represents the name of the target for which the portal information is retrieved.

TargetPortalTag [in, optional]

A USHORT value that represents a tag associated with the portal.

ElementCount [in, out]

A ULONG value that specifies the number of portals currently reported for the specified target.

Portals [out]

A variable-length array of an ISCSI_TARGET_PORTALW structure. The number of elements contained in this array is specified by the value of ElementCount.

Return value

Returns ERROR_SUCCESS if the operation is successful. If the operation fails due to a socket connection error, this function will return a Winsock 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

ReportIscsiTargetPortalsW (Unicode) and ReportIscsiTargetPortalsA (ANSI)

See also

ISCSI_TARGET_PORTALW

 

 

Community Additions

ADD
Show: