Condividi tramite


Funzione WerReportAddFile (werapi.h)

Aggiunge un file al report Segnalazione errori Windows (WER) specificato.

Sintassi

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Parametri

[in] hReportHandle

Handle per il report. Questo handle viene restituito dalla funzione WerReportCreate .

[in] pwzPath

Puntatore a una stringa Unicode contenente il percorso completo del file da aggiungere. Questo percorso può usare le variabili di ambiente. La lunghezza massima di questo percorso è MAX_PATH caratteri.

[in] repFileType

Tipo di file. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione WER_FILE_TYPE .

Valore Significato
WerFileTypeHeapdump Minidump esteso che contiene dati aggiuntivi, ad esempio la memoria del processo.
WerFileTypeMicrodump Minidump limitato che contiene solo un'analisi dello stack.
WerFileTypeMinidump Un file minidump.
WerFileTypeOther Qualsiasi altro tipo di file. Questo file verrà sempre aggiunto al cab (ma solo se il server richiede un cab).
WerFileTypeUserDocument Documento in uso dall'applicazione al momento dell'evento. Il documento viene aggiunto solo se il server richiede questo tipo di documento.

[in] dwFileFlags

Questo parametro può essere uno o più dei valori seguenti.

Valore Significato
WER_FILE_ANONYMOUS_DATA Il file non contiene informazioni personali che possono essere utilizzate per identificare o contattare l'utente.
WER_FILE_DELETE_WHEN_DONE Eliminare automaticamente il file dopo l'invio del report.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo o un codice di errore in caso di errore, incluso il codice di errore seguente.

Codice restituito Descrizione
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) Il file specificato non esiste.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) Il file specificato è un documento utente e viene archiviato in un file system crittografato; questa combinazione non è supportata.

Commenti

Anche se questa funzione può essere usata anche per aggiungere dump di memoria (usando flag specifici) al report degli errori, la funzione preferita da usare per l'aggiunta di dump di memoria è WerReportAddDump. È consigliabile usare questa funzione solo se si vuole raccogliere manualmente il dump e quindi aggiungerlo al report.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione werapi.h
Libreria Wer.lib
DLL Wer.dll

Vedi anche

WerReportCreate, Segnalazione errori Windows