3.1.4.1.5 MSFT_NetEventProvider CreateInstance

CreateInstance is an intrinsic method of the MSFT_NetEventProviderClass (section 2.3.1.2) and is used to create a new instance of a MSFT_NetEventProvider class on the server. This method returns the newly created instance. For more information, see [DMTF-DSP0200] section 2.3.2.6.

The client MUST assign a valid value to the Guid property identifying one of the event providers on the server.

The client MUST assign a valid value to the SessionGuid property. The value MUST identify an existing MSFT_NetEventSession object.

When the CreateInstance method is called, the server MUST check that the event provider identified in the Guid property and the MSFT_NetEventSession object identified in the SessionGuid property are present on the system. If they are not present, the server MUST return a NULL object.

Otherwise, the server MUST verify that the value of the Name property matches the name of the event provider in the provider manifest, and that the value of the SessionName property matches the Session Name field of the event session. If both values do not match, the server MUST return a NULL object.

When both values do match, the server MUST attempt to create an entry in the Associated Provider List of the event session, and if it cannot do so, return a NULL object.

On success, the server MUST return the resulting MSFT_NetEventProvider object.