AddPersistentIScsiDeviceA function (iscsidsc.h)

The AddPersistentIscsiDevice function adds a volume device name, drive letter, or mount point symbolic link to the list of iSCSI persistently bound volumes and devices.

Syntax

ISDSC_STATUS ISDSC_API AddPersistentIScsiDeviceA(
  [in] PSTR DevicePath
);

Parameters

[in] DevicePath

A drive letter or symbolic link for a mount point of the volume.

Return value

Returns ERROR_SUCCESS if the operation succeeds. Otherwise, it returns one of the following:

Return code Description
ISDSC_DEVICE_NOT_ISCSI_OR_PERSISTENT
The volume or device is not located on a iSCSI target or the session to the iSCSI target is not persistent.
ISDSC_VOLUME_ALREADY_PERSISTENTLY_BOUND
The volume or device is already in the persistent volume or device list.

Remarks

Note

The iscsidsc.h header defines AddPersistentIScsiDevice as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header iscsidsc.h
Library Iscsidsc.lib
DLL Iscsidsc.dll

See also

ClearPersistentScsiDevices

RemoveIscsiPersistentTarget

RemovePersistentIscsiDevice

ReportIscsiPersistentLogins

ReportPersistentIscsiDevices

SetupPersistentIscsiDevices