ReportIscsiTargets function

The ReportIscsiTargets function retrieves the list of targets that the iSCSI initiator service has discovered, and can also instruct the iSCSI initiator service to refresh the list.

Syntax


 WINAPI ReportIscsiTargets(
  _In_    BOOLEAN ForceUpdate,
  _Inout_ PULONG  BufferSize,
  _Out_   PTCHAR  Buffer
);

Parameters

ForceUpdate [in]

If true, the iSCSI initiator service updates the list of discovered targets before returning the target list data to the caller.

BufferSize [in, out]

A ULONG value that specifies the number of list elements contained by the Buffer parameter.

Buffer [out]

Pointer to a buffer that receives and contains the list of targets. The list consists of null-terminated strings. The last string, however, is double null-terminated.

Return value

Returns ERROR_SUCCESS if the operation succeeds and ERROR_INSUFFICIENT_BUFFER if the buffer size is insufficient to contain the output data. Otherwise, ReportIscsiTargets returns the appropriate Win32 or iSCSI error code on failure.

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

ReportIscsiTargetsW (Unicode) and ReportIscsiTargetsA (ANSI)

See also

ReportIscsiSendTargetPortals

 

 

Community Additions

ADD
Show: