ReportActiveIscsiTargetMappings function

ReportActiveIscsiTargetMappings function retrieves the target mappings that are currently active for all initiators on the computer.

Syntax


HRESULT WINAPI ReportActiveIscsiTargetMappings(
  _Inout_  PULONG BufferSize,
  _Out_    PULONG MappingCount,
  _Out_    PISCSI_TARGET_MAPPING Mappings
);

Parameters

BufferSize [in, out]

A pointer to a location that, on input, contains the size, in bytes, of the buffer that Mappings points to. If the operation succeeds, the location receives the size, in bytes, of the mapping data that was retrieved. If the buffer that Mappings points to is not sufficient to contain the output data, the location receives the buffer size, in bytes, that is required.

MappingCount [out]

If the operation succeeds, the location pointed to by MappingCount receives the number of mappings that were retrieved.

Mappings [out]

A pointer to an array of type ISCSI_TARGET_MAPPING that, on output, is filled with the active target mappings for all initiators.

Return value

Returns ERROR_SUCCESS if the operation succeeds and ERROR_INSUFFICIENT_BUFFER if the buffer is not large enough.

Otherwise, ReportActiveIscsiTargetMappings returns the appropriate Win32 or iSCSI error code on failure.

Remarks

Target mappings associate bus, target and LUN numbers with the LUNs on a target device.

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

ReportActiveIscsiTargetMappingsW (Unicode) and ReportActiveIscsiTargetMappingsA (ANSI)

See also

ISCSI_TARGET_MAPPING

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.