IProfile

Rappresenta un profilo che controlla il client. L'interfaccia fornisce funzioni che caricano un profilo, in formato XML, da un file o da una stringa. Il client può determinare se l'utente può aggiornare il profilo aggiungendo o rimuovendo provider di Traccia eventi per Windows (ETW).

Sintassi

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

Funzioni

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

Funzione	Descrizione
propget	Restituisce il valore della proprietà specificata.
propput	Imposta la proprietà specificata.
LoadFromFile	Carica un profilo dal file specificato.
LoadFromString	Carica un profilo dalla stringa di definizione del profilo XML specificata.
IsEqual	Confronta due oggetti IProfile .

Proprietà

Questa interfaccia fornisce le proprietà descritte nella tabella seguente.

Proprietà	Parametri	Descrizione
IsMutable	pfMutable	[out] Restituisce un valore booleano che indica che è possibile aggiungere sessioni e provider a un profilo esistente quando i profili dello stesso nome vengono combinati con il metodo IProfileCollection::Add . S_OK indica l'esito positivo.
IsMutable	fMutable	[in] Valore booleano che indica se è possibile aggiungere sessioni e provider ai profili. S_OK indica l'esito positivo.
Versione	pVersion	[out] Indica la versione dei profili.
Autore	pbstrAuthor	[out] Indica l'autore dei profili.
Team	pbstrTeam	[out] Indica il team che ha creato i profili.
Commenti	pbstrComments	[out] Commenti facoltativi sui profili.
Company	pbstrCompany	[out] Indica l'azienda che ha creato i profili.
Copyright	pbstrCopyright	[out] Indica le informazioni sul copyright correlate ai profili.
Tag	pbstrTag	[out] Valore con tag facoltativo che può essere usato per distinguere tra i profili.
Id	pbstrId	[out] Indica l'identificatore del profilo.
Nome	pbstrName	[out] Indica il nome del profilo.
Descrizione	pbstrDescription	[out] Indica la descrizione del profilo.
LoggingMode	pLoggingMode	[out] Indica la modalità di registrazione.
LoggingModeString	pbstrLoggingMode	[out] Indica la stringa della modalità di registrazione. I valori possibili sono "memoria" e "file".
DetailLevel	pDetailLevel	[out] Indica il livello di dettaglio.
DetailLevelString	pbstrDetailLevel	[out] Indica la stringa del livello di dettaglio. I valori possibili sono "verbose" e "light".
IsStrict	pfStrict	[out] Valore booleano che indica se la registrazione viene eseguito il rollback se un agente di raccolta o un provider non viene avviato.
IsDefault	pfDefault	[out] Valore booleano che indica se si tratta di un profilo predefinito.
ProblemiCategorie	pbstrProblemCategories	[out] Indica i problemi che questo profilo è progettato per rilevare.

Argomenti correlati

Interfacce