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 );
Pointer to a variable that receives a 32-bit integer specifying the additional key.
This property method returns S_OK if the call is successful; otherwise, it returns an error code.
Property AdditionalKey As Long
A 32-bit integer that specifies the additional key.
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 0. In other words, the index 0 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.
|Client||Requires Windows Vista or Windows XP.|
|Server||Requires Windows Server 2008.|
|Version||Requires Forefront Threat Management Gateway (TMG).|
Declared in Msfpccom.idl.
Build date: 11/30/2009
© 2008 Microsoft Corporation. All rights reserved.