windows-server-2003/admin/wmi/wbem/winmgmt/esscomp/forwarding/fconprov_master.mof

��/************************************************************************

THIS IS THE MASTER MOF.  ALL CHANGES MUST OCCUR TO THIS MOF

To make a change:

1. edit this MOF
2. Generate new mof & mfl:  mofcomp -amendment:ms_409 -MOF:fconprov.mof -MFL:fconprov.mfl fconprov_Master.mof
3. edit fconprov.mfl to keep it namespace agnostic. 

*************************************************************************/


Qualifier Description : Amended;


/*****************************************************************************
    Core Schema
******************************************************************************/

[
    Locale(0x409),
    Description( "An event consumer that forwards messages to a remote "
                 "machine when it is notified of events." )
]
class MSFT_ForwardingConsumer : __EventConsumer
{
    [
        Key,
        Description( "A string uniquely identifying this consumer." )
    ]
    string Name;

    [
        Description( "An array of addresses to forward the messages to.  The "
                     "forwarding consumer will try to forward the message, "
                     "in order, to each address in the list until it "
                     "successfully sends it to one of them." )
    ]
    string Targets[];

    [ 
        Values{ 0 }, 
        Value_Map{ "Synchronous" },
        Description( "The Quality-of-Service used to forward the message." )
    ] 
    sint32 ForwardingQoS = 0;
 
    [
        Description( "Indicates whether to include authentication information "
                     "when forwarding the message." )
    ]
    boolean Authenticate = TRUE;

    [
        Description( "Indicates whether to encrypt the message before "
                     "forwarding." )
    ]
    boolean Encryption = TRUE;

    [
        Description( "An SD, in SDDL format, that is attached to the "
                     "forwarded event when it is raised on the receiving end."
                     "This SD indates to the receiver which security "
                     "identities are allowed to consume the forwarded event." )
    ]
    string TargetSD;

    [
        Description( "Indicates whether to send schema information for the "
                     "event to be forwarded.  " )
    ]
    boolean IncludeSchema = FALSE;
};

[
    Locale(0x409),
    Description( "The base class for all forwarding consumer trace events." )
]
class MSFT_FCTraceEventBase : __ExtrinsicEvent
{
    [
        Description( "Instance of the forwarding consumer that is being "
                     "executed." )
    ]
    MSFT_ForwardingConsumer Consumer;

    [
        Description( "A unique id representing the execution of a forwarding " 
                     "consumer.  This id permits correlation of all the trace "
                     "events associated with an execution of the consumer." )
    ]
    string ExecutionId;

    [
        Description( "The status code representing the outcome of the action "
                     "the trace event is associated with." )
    ]
    uint32 StatusCode;
};
    
[
    Locale(0x409),
    Description( "Represents an execution of the forwarding consumer. There "
                 "is exactly one of these events signaled each time an event "
                 "triggers a forwarding consumer to be executed." )
]
class MSFT_FCExecutedTraceEvent : MSFT_FCTraceEventBase
{
    [
        Description( "The target used to forward the message.  If the "
                     "status code indicates an error, this means that no "
                     "target was used and this value will be NULL." )
    ]  
    string TargetUsed;

    [
        Description( "Indicates whether the message was queued for forwarding "
                     "at a later time." )
    ]
    boolean Queued; 

    [
        Description( "The array of events that were forwarded." )
    ]
    __Event Events[];
};

[
    Locale(0x409),
    Description( "Represents the attempt to forward a message to a target." )
]
class MSFT_FCTargetTraceEvent : MSFT_FCTraceEventBase
{
    [
        Description( "The low-level target address that was used when "
                     "attempting to forward the message." )
    ]
    string Target;
};

/****************************************************************************
    Internal Schema and Registrations 
*****************************************************************************/

instance of __Win32Provider as $PE
{
    Name = "Microsoft WMI Forwarding Consumer Trace Event Provider";
    Clsid = "{AD1B46E8-0AAC-401b-A3B8-FCDCF8186F55}";
    HostingModel = "Decoupled:Com";
};

instance of __EventProviderRegistration
{
    Provider = $PE;
    EventQueryList = { "SELECT * FROM MSFT_FCTraceEventBase" };
};

instance of __Win32Provider as $P
{
    Name = "Microsoft WMI Forwarding Consumer Provider";
    Clsid = "{AD1B46E8-0AAC-401b-A3B8-FCDCF8186F55}";
    HostingModel = "WmiCore";
};

instance of __EventConsumerProviderRegistration
{
    Provider = $P;
    ConsumerClassNames = { "MSFT_ForwardingConsumer" };
};