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 |