IControlManager

Rappresenta il gestore di Windows Performance Recorder, che controlla le sessioni di Traccia eventi per Windows (ETW). Il client passa una raccolta di profili usando l'interfaccia IProfileCollection e il gestore può avviare, aggiornare, annullare, salvare, arrestare o eseguire query sulla sessione OTW o sui provider descritti da ogni profilo. Il client può passare un puntatore al gestore IControlProgressHandler per ricevere aggiornamenti sull'operazione eseguita dal gestore.

Sintassi

{
  [propget, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([out, retval] IControlProgressHandler** ppControlProgressHandler);
  [propput, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([in] IControlProgressHandler* pControlProgressHandler);
  [id(2), helpstring("Start")] HRESULT Start
    ([in] IProfileCollection* pProfileCollection);
  [id(3), helpstring("Update")] HRESULT Update
    ([in] IProfileCollection* pProfileCollection);
  [id(4), helpstring("Cancel")] HRESULT Cancel
    ([in] IProfileCollection* pProfileCollection);
  [id(5), helpstring("Save")] HRESULT Save
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(6), helpstring("Stop")] HRESULT Stop
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(7), helpstring("QueryXML")] HRESULT QueryXML
    ([out] BSTR* pbstrResults,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [id(8), helpstring("Query")] HRESULT Query
    ([out] IProfileCollection** ppProfileCollection,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [propget, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([out, retval] ITraceMergeTextHandler** ppTraceMergeTextHandler);
  [propput, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([in] ITraceMergeTextHandler* pTraceMergeTextHandler);
  [propget, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([out, retval] BSTR* pbstrTemporaryTraceDirectory);
  [propput, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([in] BSTR bstrTemporaryTraceDirectory);
  [id(11), helpstring("GetProviderNameFromGuid")] HRESULT GetProviderNameFromGuid
    ([out] BSTR* bstrProviderIdStr,
    [in] REFGUID ProviderId);
  [id(12), helpstring("GetProviderGuidFromName")] HRESULT GetProviderGuidFromName
    ([out] GUID* ProviderId,
    [in] BSTR bstrProViderName);
};

Funzioni

Nella tabella seguente vengono descritte le funzioni fornite da questa interfaccia.

Funzione	Descrizione
Inizia	Avvia una registrazione.
Aggiornamento	Aggiornamenti una raccolta di profili.
Annulla	Arresta una registrazione senza salvare i dati.
Salva	Salva una registrazione registrata in buffer circolari in memoria nel file ETL (Data Trace Log eventi) specificato.
Stop	Arresta una registrazione e la salva nel file di traccia eventi (ETL) specificato.
QueryXML	Indica il formato XML del profilo attualmente in esecuzione e se il profilo è in esecuzione correttamente.
Query	Esegue query sulle proprietà di sessioni e provider in tutti i profili.
propget	Ottiene la proprietà specificata.
propput	Imposta la proprietà specificata.
GetProviderNameFromGuid	Ottiene il nome del provider del GUID specificato.
GetProviderGuidFromName	Ottiene il GUID del provider del nome specificato.

Proprietà

La tabella seguente descrive i parametri delle proprietà che questa interfaccia può ottenere o impostare.

Proprietà	Parametri	Descrizione
ControlProgressHandler	ppControlProgressHandler [out]	Puntatore all'implementazione lato client dell'interfaccia IControlProgressHandler .
ControlProgressHandler	pControlProgressHandler [in]	Puntatore all'implementazione lato client dell'interfaccia IControlProgressHandler . E_POINTER indica un puntatore non valido.
TraceMergeTextHandler	ppTraceMergeTextHandler [out]	Puntatore al testo e altre informazioni sull'ora di unione nell'interfaccia ITraceMergeTextHandler immesse.
TraceMergeTextHandler	pTraceMergeTextHandler [in]	Puntatore al testo e altre informazioni sull'ora di unione nell'interfaccia ITraceMergeTextHandler immesse. E_POINTER indica un puntatore non valido.
TemporaryTraceDirectory	pbstrTemporaryTraceDirectory [out]	Puntatore al percorso della directory in cui vengono registrati i file di traccia pre-uniti. Il valore predefinito è la cartella %temp% .
TemporaryTraceDirectory [in]	bstrTemporaryTraceDirectory	Percorso della directory in cui vengono registrati i file di traccia pre-uniti.

Argomenti correlati

Interfacce