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