[C++]

The AdditionalKey property gets the additional key (index) in the table of subevents defined for the event for which the alert is issued.

HRESULT get_AdditionalKey(
  long* plKey
);

Parameters

plKey

Pointer to a variable that receives a 32-bit integer specifying the additional key.

Return Values

This property method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

This property is read-only. Its value can be modified, along with the values of the EventGUID and ServerName properties, by calling the SetDefinitions method.

Additional keys serve as a means to subdivide event objects into related subevents. For example, a disk-full event can be subdivided into log-disk-full and system-disk-full subevents. This provides for the issuing of either different alerts that are specific to subevents or a single alert that is specific to all subevents.

For example, an administrator can add separate alerts for each separate subevent by specifying the applicable values of the EventGUID and AdditionalKey properties for each subevent. The AdditionalKey property is the index used in the table of subevents. Alternatively, an administrator can treat all subevents as a single event by specifying the EventGUID and setting the AdditionalKey to zero. In other words, the index zero is reserved and should not be overloaded with a user-specified subevent.

If an event has no subevents, the value of this property should be –1.

The table of subevents cannot be modified; an administrator can only select keys from the table.

[Visual Basic]

The AdditionalKey property gets the additional key (index) in the table of subevents defined for the event for which the alert is issued.

Property AdditionalKey As Long

Property Value

A 32-bit integer that specifies the additional key.

Remarks

This property is read-only. Its value can be modified, along with the values of the EventGUID and ServerName properties, by calling the SetDefinitions method.

Additional keys serve as a means to subdivide event objects into related subevents. For example, a disk-full event can be subdivided into log-disk-full and system-disk-full subevents. This provides for the issuing of either different alerts that are specific to subevents or a single alert that is specific to all subevents.

For example, an administrator can add separate alerts for each separate subevent by specifying the applicable values of the EventGUID and AdditionalKey properties for each subevent. The AdditionalKey property is the index used in the table of subevents. Alternatively, an administrator can treat all subevents as a single event by specifying the EventGUID and setting the AdditionalKey to zero. In other words, the index zero is reserved and should not be overloaded with a user-specified subevent.

If an event has no subevents, the value of this property should be –1.

The table of subevents cannot be modified; an administrator can only select keys from the table.