Funzione MsiEnableLogA (msi.h)

  • Articolo

La funzione MsiEnableLog imposta la modalità di log per tutte le installazioni successive avviate nel processo chiamante.

Sintassi

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

Parametri

[in] dwLogMode

Specifica la modalità di log. Questo parametro può essere uno o più dei valori seguenti.

Valore Significato
INSTALLLOGMODE_FATALEXIT
 Disconnettersi dalla memoria o dalle informazioni di uscita irreversibili.
INSTALLLOGMODE_ERROR
 Registra i messaggi di errore.
INSTALLLOGMODE_EXTRADEBUG
 Invia informazioni di debug aggiuntive, ad esempio gestire le informazioni di creazione, al file di log.

Windows 2000 e Windows XP: Questa funzionalità non è supportata.
INSTALLLOGMODE_WARNING
 Registra i messaggi di avviso.
INSTALLLOGMODE_USER
 Registra le richieste dell'utente.
INSTALLLOGMODE_INFO
 Registra i messaggi di stato non visualizzati.
INSTALLLOGMODE_RESOLVESOURCE
 Richiedere di determinare un percorso di origine valido.
INSTALLLOGMODE_OUTOFDISKSPACE
 Indica spazio su disco insufficiente.
INSTALLLOGMODE_ACTIONSTART
 Registra l'inizio delle nuove azioni di installazione.
INSTALLLOGMODE_ACTIONDATA
 Registra il record di dati con l'azione di installazione.
INSTALLLOGMODE_COMMONDATA
 Registra i parametri per l'inizializzazione dell'interfaccia utente.
INSTALLLOGMODE_PROPERTYDUMP
 Registra i valori della proprietà alla terminazione.
INSTALLLOGMODE_VERBOSE
 Registra le informazioni in tutte le altre modalità di log, ad eccezione di INSTALLLOGMODE_EXTRADEBUG. Ciò invia grandi quantità di informazioni a un file di log in genere non utile agli utenti. Può essere usato per il supporto tecnico.
INSTALLLOGMODE_LOGONLYONERROR
 Le informazioni di registrazione vengono raccolte ma vengono salvate meno frequentemente nel file di log. Ciò può migliorare le prestazioni di alcune installazioni, ma può avere un vantaggio minimo per le installazioni di grandi dimensioni. Il file di log viene rimosso quando l'installazione ha esito positivo. Se l'installazione non riesce, tutte le informazioni di registrazione vengono salvate nel file di log.

Windows Installer 2.0: Questa modalità di log non è disponibile.

[in] szLogFile

Specifica la stringa che contiene il percorso completo del file di log. Se si immette un valore Null, la registrazione viene disabilitata, nel qual caso dwlogmode viene ignorata. Se viene specificato un percorso, dwlogmode non deve essere zero.

[in] dwLogAttributes

Specifica la frequenza di scaricamento del buffer del log.

Valore Significato
INSTALLLOGATTRIBUTES_APPEND
 Se questo valore è impostato, il programma di installazione aggiunge il log esistente specificato da szLogFile. Se non impostato, qualsiasi log esistente specificato da szLogFile viene sovrascritto.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 Forza lo scaricamento del buffer di log dopo ogni riga. Se questo valore non è impostato, il programma di installazione scarica il buffer di log dopo 20 righe chiamando FlushFileBuffers.

Valore restituito

Valore Significato
ERROR_INVALID_PARAMETER
 È stata specificata una modalità di log non valida.
ERROR_SUCCESS
 Funzione completata.

Commenti

Per una descrizione dei criteri di registrazione, vedere Criteri di sistema.

Il percorso del file di log deve esistere già quando si usa questa funzione. Il programma di installazione non crea la struttura di directory per il file di log.

Nota

L'intestazione msi.h definisce MsiEnableLog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
Client minimo supportato Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione Windows
Intestazione msi.h
Libreria Msi.lib
DLL Msi.dll

Vedi anche

Funzioni di interfaccia e registrazione

Logging