RefreshIsnsServer function

The RefreshIsnsServer function instructs the iSCSI initiator service to query the indicated Internet Storage Name Service (iSNS) server to refresh the list of discovered targets for the iSCSI initiator service.

Syntax


HRESULT WINAPI RefreshIsnsServer(
  _In_ PTCHAR Address
);

Parameters

Address [in]

The DNS or IP Address of the iSNS server.

Return value

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

Remarks

If the refresh succeeds, the iSCSI initiator service replaces the previous list of targets discovered by the indicated iSNS server with the updated list.

If the iSNS server supports State Change Notifications (SCN), the iSCSI initiator can keep the iSNS target list up to date, without requiring calls of the RefreshIsnsServer function.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Iscsidsc.h

Library

Iscsidsc.lib

DLL

Iscsidsc.dll

Unicode and ANSI names

RefreshIsnsServerW (Unicode) and RefreshIsnsServerA (ANSI)

See also

AddIsnsServer
RemoveIsnsServer
ReportIsnsServerList

 

 

Community Additions

ADD
Show: