SetGenerationalGuid

The SetGenerationalGuid method assigns a new GUID value to the information in the initiator HBA's caches.

Initiator HBAs often cache authentication information such as preshared keys that are associated with particular initiator identifiers, group keys that are associated by default with initiator identifiers that have no key, and CHAP secrets. The initiator maintains a GUID that identifies the version of the information that is currently in its caches.

Services, such as the iSCSI discovery service, and management applications that update an initiator's cached information should change this GUID to indicate that the cache has been modified. When an iSCSI service or management application restarts, it can check the initiator HBA's GUID to verify that its cached information is synchronized with the cached information on the initiator.

Applications and services can use the following iSCSI WMI methods to manage an initiators' cached configuration data:

ClearCache

GetPresharedKeyForId

SetGroupPresharedKey

SetPresharedKeyForId

SetTunnelModeOuterAddress

The SetGenerationalGuid method belongs to the unpublished MSiSCSI_SecurityConfigOperations WMI class. For a description of the parameters of the SetGenerationalGuid method, see the member descriptions for the SetGenerationalGuid_IN and SetGenerationalGuid_OUT structures. Miniport drivers that implement the MSiSCSI_SecurityConfigOperations WMI class must support this method if the HBA caches information.