Iprofile

Representa um perfil que o cliente controla. A interface fornece funções que carregam um perfil, no formato XML, de um arquivo ou de uma cadeia de caracteres. O cliente pode determinar se o usuário tem permissão para atualizar para o perfil adicionando ou removendo provedores ETW (Rastreamento de Eventos para Windows).

Sintaxe

{
  typedef enum
  {
    LoggingMode_Unknown,
    LoggingMode_Memory,
    LoggingMode_File,
  }
  CLoggingMode;
  typedef enum
  {
    DetailLevel_Unknown,
    DetailLevel_Light,
    DetailLevel_Verbose,
  }
  CDetailLevel;
  [propget, id(1), helpstring("IsMutable")] HRESULT IsMutable
    ([out, retval] VARIANT_BOOL* pfMutable);
  [propput, id(1), helpstring("IsMutable")] HRESULT IsMutable
    ([in] VARIANT_BOOL fMutable);  [propget, id(2), helpstring("Version")] HRESULT Version
    ([out, retval] float* pVersion);
  [propget, id(3), helpstring("Author")] HRESULT Author
    ([out, retval] BSTR* pbstrAuthor);
  [propget, id(4), helpstring("Team")] HRESULT Team
    ([out, retval] BSTR* pbstrTeam);
  [propget, id(5), helpstring("Comments")] HRESULT Comments
    ([out, retval] BSTR* pbstrComments);
  [propget, id(6), helpstring("Company")] HRESULT Company
    ([out, retval] BSTR* pbstrCompany);
  [propget, id(7), helpstring("Copyright")] HRESULT Copyright
    ([out, retval] BSTR* pbstrCopyright);
  [propget, id(8), helpstring("Tag")] HRESULT Tag
    ([out, retval] BSTR* pbstrTag);
  [propget, id(9), helpstring("Id")] HRESULT Id
    ([out, retval] BSTR* pbstrId);
  [propget, id(10), helpstring("Name")] HRESULT Name
    ([out, retval] BSTR* pbstrName);
  [propget, id(11), helpstring("Description")] HRESULT Description
    ([out, retval] BSTR* pbstrDescription);
  [propget, id(12), helpstring("LoggingMode")] HRESULT LoggingMode
    ([out, retval] CLoggingMode* pLoggingMode);
  [propget, id(13), helpstring("LoggingModeString")] HRESULT LoggingModeString
    ([out, retval] BSTR* pbstrLoggingMode);
  [propget, id(14), helpstring("DetailLevel")] HRESULT DetailLevel
    ([out, retval] CDetailLevel* pDetailLevel);
  [propget, id(15), helpstring("DetailLevelString")] HRESULT DetailLevelString
    ([out, retval] BSTR* pbstrDetailLevel);
  [propget, id(16), helpstring("IsStrict")] HRESULT IsStrict
    ([out, retval] VARIANT_BOOL* pfStrict);
  [propget, id(17), helpstring("IsDefault")] HRESULT IsDefault
    ([out, retval] VARIANT_BOOL* pfDefault);
  [propget, id(18), helpstring("ProblemCategories")] HRESULT ProblemCategories
    ([out, retval] BSTR* pbstrProblemCategories);
  [id(19), helpstring("LoadFromFile")] HRESULT LoadFromFile
    ([in] BSTR bstrProfileName,
    [in] BSTR bstrFileName);
  [id(20), helpstring("LoadFromString")] HRESULT LoadFromString
    ([in] BSTR bstrProfile);
  [id(21), helpstring("IsEqual")] HRESULT IsEqual
    ([in] IProfile* pProfile);};

Funções

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

Função	Descrição
propget	Retorna o valor da propriedade especificada.
propput	Define a propriedade especificada.
LoadFromFile	Carrega um perfil do arquivo especificado.
LoadFromString	Carrega um perfil da cadeia de caracteres de definição de perfil XML especificada.
IsEqual	Compara dois objetos IProfile .

Propriedades

Essa interface fornece as propriedades descritas na tabela a seguir.

Propriedade	Parâmetros	Descrição
IsMutable	pfMutable	[out] Retorna um valor booliano que indica que sessões e provedores podem ser adicionados a um perfil existente quando perfis de mesmo nome são combinados com o método IProfileCollection::Add . S_OK indica êxito.
IsMutable	fMutável	[in] Um valor booliano que indica se sessões e provedores podem ser adicionados aos perfis. S_OK indica êxito.
Versão	pVersion	[out] Indica a versão dos perfis.
Autor	pbstrAuthor	[out] Indica o autor dos perfis.
Equipe	pbstrTeam	[out] Indica a equipe que criou os perfis.
Comentários	pbstrComments	[out] Comentários opcionais sobre os perfis.
Empresa	pbstrCompany	[out] Indica a empresa que criou os perfis.
Direitos autorais	pbstrCopyright	[out] Indica informações de direitos autorais relacionadas aos perfis.
Tag	pbstrTag	[out] Valor marcado opcional que pode ser usado para diferenciar entre perfis.
Id	pbstrId	[out] Indica o identificador do perfil.
Nome	pbstrName	[out] Indica o nome do perfil.
Descrição	pbstrDescription	[out] Indica a descrição do perfil.
LoggingMode	pLoggingMode	[out] Indica o modo de registro em log.
LoggingModeString	pbstrLoggingMode	[out] Indica a cadeia de caracteres do modo de registro em log. Os valores possíveis são "memory" e "file".
DetailLevel	pDetailLevel	[out] Indica o nível de detalhes.
DetailLevelString	pbstrDetailLevel	[out] Indica a cadeia de caracteres de nível de detalhe. Os valores possíveis são "detalhado" e "light".
Isstrict	pfStrict	[out] Um booliano que indica se a gravação será revertida se algum coletor ou provedor não for iniciado.
IsDefault	pfDefault	[out] Um booliano que indica se esse é um perfil padrão.
ProblemCategories	pbstrProblemCategories	[out] Indica os problemas que esse perfil foi projetado para detectar.

Tópicos relacionados

Interfaces