Edit

VDS_PORTAL_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_NOTIFICATION {
  ULONG         ulEvent;
  VDS_OBJECT_ID portalId;
} VDS_PORTAL_NOTIFICATION;

Members

ulEvent

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

Value Meaning
VDS_NF_PORTAL_ARRIVE
123
 An iSCSI portal has been created.
VDS_NF_PORTAL_DEPART
124
 An existing iSCSI portal has been removed.
VDS_NF_PORTAL_MODIFY
125
 An existing iSCSI portal has changed. An example of change that triggers this notification would be changes to the VDS_ISCSI_PORTAL_PROP structure. Applications are responsible for determining the nature of any changes.

portalId

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 object, use the IVdsService::GetObject method. You can then use the IVdsIscsiPortal::GetProperties method to get the portal 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_PORTAL_PROP

VDS_NOTIFICATION