3.2.4.11.15 Query (Opnum 21)

  • Article

The Query method, takes the name (or PLA-UID) of an event trace data provider installed on the system and populates the state of the ITraceDataProvider with the stored settings for that event trace provider. Each event trace provider installed on the machine has to have a unique PLA-UID and name which identify it so it is not possible for the name (or PLA-UID) to correspond to more than one of the event trace providers installed on the system.

The DisplayName, Guid, Level, KeywordsAny, KeywordsAll, and Properties properties of the ITraceDataProvider will be set by this method. The Guid in this context refers to the COM interface property which is used as a PLA-UID and does not comply with the semantics of GUID specified in [C706].See section 3.2.4.11. When these properties are set, any previous values will be lost.

 HRESULT Query(
   [in] BSTR bstrName,
   [in, unique] BSTR bstrServer
 );

bstrName: Supplies the name of the registered provider or the PLA-UID of the registered provider formatted as a string.

bstrServer: Not used.

Return Values: This method MUST return an HRESULT with the severity bit clear on success as specified in [MS-ERREF]; otherwise, it MUST return one of the errors as defined in 2.2.1 or one of the errors as defined in [MS-ERREF] section 2.1.