Skip to content

Latest commit

 

History

History
81 lines (59 loc) · 2.76 KB

nf-iscsidsc-setuppersistentiscsidevices.md

File metadata and controls

81 lines (59 loc) · 2.76 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:iscsidsc.SetupPersistentIScsiDevices
SetupPersistentIScsiDevices function (iscsidsc.h)
SetupPersistentIscsiDevices function builds the list of devices and volumes assigned to iSCSI targets that are connected to the computer, and saves this list in non-volatile cache of the iSCSI initiator service.
SetupPersistentIScsiDevices
SetupPersistentIscsiDevices
SetupPersistentIscsiDevices function [iSCSI Discovery Library API]
iscsidisc.setuppersistentiscsidevices
iscsidsc/SetupPersistentIscsiDevices
iscsidisc\setuppersistentiscsidevices.htm
iSCSIDisc
b21e5872-24b2-4a4c-86a7-528789c1b9aa
12/05/2018
SetupPersistentIScsiDevices, SetupPersistentIscsiDevices, SetupPersistentIscsiDevices function [iSCSI Discovery Library API], iscsidisc.setuppersistentiscsidevices, iscsidsc/SetupPersistentIscsiDevices
iscsidsc.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Iscsidsc.lib
Iscsidsc.dll
Windows
19H1
SetupPersistentIScsiDevices
iscsidsc/SetupPersistentIScsiDevices
c++
APIRef
kbSyntax
DllExport
Iscsidsc.dll
SetupPersistentIscsiDevices

SetupPersistentIScsiDevices function

-description

The SetupPersistentIscsiDevices function builds the list of devices and volumes assigned to iSCSI targets that are connected to the computer, and saves this list in non-volatile cache of the iSCSI initiator service.

-returns

Returns ERROR_SUCCESS if the operation succeeds. Otherwise, it returns the appropriate Win32 or iSCSI error code.

-remarks

When the iSCSI Initiator service starts, it does not complete initialization until the storage stack can access and enumerate all persistent iSCSI volumes and devices. If there is a service that is dependent on data stored on a persistent volume or device, it should be configured to have a dependency on the iSCSI service (MSiSCSI).

The correct procedure for a system administrator to configure a computer to use external persistent volumes is as follows:

  • Login to all of the targets that contain the volumes
  • Configure all volumes on top of the disks
  • Use management software to call the SetupPersistentIscsiDevices routine, so that the iSCSI initiator service will add the volumes to its list of persistent volumes.