IControlManager

Representa o gerenciador do Gravador de Desempenho do Windows, que controla as sessões etw (Rastreamento de Eventos para Windows). O cliente passa uma coleção de perfis usando a interface IProfileCollection e o gerente pode iniciar, atualizar, cancelar, salvar, parar ou consultar a sessão etw ou provedores que cada perfil descreve. O cliente pode passar um ponteiro para o manipulador IControlProgressHandler para receber atualizações sobre a operação executada pelo gerente.

Sintaxe

{
  [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);
};

Funções

A tabela a seguir descreve as funções que essa interface fornece.

Função	Descrição
Iniciar	Inicia uma gravação.
Atualização	Atualizações uma coleção de perfis.
Cancelar	Interrompe uma gravação sem salvar dados.
Salvar	Salva uma gravação registrada em buffers circulares na memória no arquivo ETL (log de rastreamento de eventos) especificado.
Parar	Interrompe uma gravação e salva-a no arquivo ETL (log de rastreamento de eventos) especificado.
QueryXML	Indica o formato XML do perfil em execução no momento e se o perfil está sendo executado corretamente.
Consulta	Consulta as propriedades de sessão e provedores em todos os perfis.
propget	Obtém a propriedade especificada.
propput	Define a propriedade especificada.
GetProviderNameFromGuid	Obtém o nome do provedor do GUID especificado.
GetProviderGuidFromName	Obtém o GUID do provedor do nome especificado.

Propriedades

A tabela a seguir descreve os parâmetros das propriedades que essa interface pode obter ou definir.

Propriedade	Parâmetros	Descrição
ControlProgressHandler	ppControlProgressHandler [out]	Ponteiro para a implementação do lado do cliente da interface IControlProgressHandler .
ControlProgressHandler	pControlProgressHandler [in]	Ponteiro para a implementação do lado do cliente da interface IControlProgressHandler . E_POINTER indica um ponteiro inválido.
TraceMergeTextHandler	ppTraceMergeTextHandler [out]	Ponteiro para o texto e algumas outras informações de tempo de mesclagem no rastreamento injetado pela interface ITraceMergeTextHandler .
TraceMergeTextHandler	pTraceMergeTextHandler [in]	Ponteiro para o texto e algumas outras informações de tempo de mesclagem no rastreamento injetado pela interface ITraceMergeTextHandler . E_POINTER indica um ponteiro inválido.
TemporaryTraceDirectory	pbstrTemporaryTraceDirectory [out]	Ponteiro para o caminho do diretório em que os arquivos de rastreamento pré-mesclados são registrados. O padrão é a pasta %temp%.
TemporaryTraceDirectory [in]	bstrTemporaryTraceDirectory	Caminho do diretório em que os arquivos de rastreamento pré-mesclados são registrados.

Tópicos relacionados

Interfaces