Edit

VDS_PORTAL_GROUP_NOTIFICATION structure (vds.h)

  • Article

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Defines the details of iSCSI portal events.

Syntax

typedef struct _VDS_PORTAL_GROUP_NOTIFICATION {
  ULONG         ulEvent;
  VDS_OBJECT_ID portalGroupId;
} VDS_PORTAL_GROUP_NOTIFICATION;

Members

ulEvent

Determines the iSCSI portal group event for which an application will be notified, as one of the following values.

Value Meaning
VDS_NF_PORTAL_GROUP_ARRIVE
129
 An iSCSI portal group has been created.
VDS_NF_PORTAL_GROUP_DEPART
130
 An existing iSCSI portal group has been deleted.
VDS_NF_PORTAL_GROUP_MODIFY
131
 An existing iSCSI portal group has changed. An example of change that triggers this notification would be changes to the VDS_ISCSI_PORTALGROUP_PROP structure. Applications are responsible for determining the nature of any changes.

portalGroupId

The VDS_OBJECT_ID of the iSCSI portal that triggered the event.

Remarks

The VDS_NOTIFICATION structure includes this structure as a member.

An application can receive disk events by implementing the IVdsAdviseSink interface and passing the interface pointer as an argument to the IVdsService::Advise method.

To get the portal group object, use the IVdsService::GetObject method. You can then use the IVdsIscsiPortalGroup::GetProperties method to get the portal group properties.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Header vds.h
Redistributable VDS 1.1

See also

IVdsAdviseSink

IVdsIscsiPortal

IVdsService::Advise

VDS Structures

VDS_ISCSI_PORTALGROUP_PROP

VDS_NOTIFICATION