ReportActiveIScsiTargetMappingsA function (iscsidsc.h)

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

Syntax

ISDSC_STATUS ISDSC_API ReportActiveIScsiTargetMappingsA(
  [in, out] PULONG                 BufferSize,
  [out]     PULONG                 MappingCount,
  [out]     PISCSI_TARGET_MAPPINGA Mappings
);

Parameters

[in, out] BufferSize

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.

[out] MappingCount

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

[out] Mappings

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

See also

ISCSI_TARGET_MAPPING