StarBurn SDK (Software Development Kit)
ContentsIndexHome
PreviousUpNext
StarBurn_StarPort_DeviceListQueryRemote Function
C++
__stdcall STARBURN_IMPEX_API EXCEPTION_NUMBER StarBurn_StarPort_DeviceListQueryRemote(IN PCHAR p__PCHAR__TargetAddress, OUT PSTARPORT_DEVICE_LIST p__PSTARPORT_DEVICE_LIST, IN ULONG p__ULONG__StarPortDeviceListSizeInUCHARs, OUT PLONG p__PLONG__NumberOfTargets, OUT PULONG p__PULONG__SystemError);
Parameters 
Description 
IN PCHAR p__PCHAR__TargetAddress 
Pointer to IP:port string which corresponds to the iSCSI target we'd like to query.
 
OUT PSTARPORT_DEVICE_LIST p__PSTARPORT_DEVICE_LIST 
Pointer to the STARPORT_DEVICE_LIST structure drive would fill with StarPort device list information.
 
IN ULONG p__ULONG__StarPortDeviceListSizeInUCHARs 
True STARPORT_DEVICE_LIST structure size in UCHARs.
 
OUT PLONG p__PLONG__NumberOfTargets 
Pointer to the variable to receive number of targets StarPort would enumerate during this call.
 
OUT PULONG p__PULONG__SystemError 
Pointer to the variable to receive system error if function would return anything except EN_SUCCESS. 

Execution status.

This function gets device list from remote StarWind iSCSI target. StarWind exports RAM disk, hard disk and DVD-ROM emulator, AoE (ATA-over-Ethernet) and iSCSI (SCSI-over-IP) targets. Unlike StarBurn_StarPort_DeviceListQueryLocal API call which retreives information about LOCAL device list this call gets information about REMOTE device list.

This one is for Network license holders only.

Please see StarPort sample as example how to use StarBurn_StarPort_DeviceListQueryRemote API call.