AddPersistentIScsiDeviceA function (iscsidsc.h)

Article
02/22/2024

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