Funzione WerRegisterFile (werapi.h)
Registra un file da raccogliere quando Segnalazione errori Windows (WER) crea una segnalazione errori.
Sintassi
HRESULT WerRegisterFile(
[in] PCWSTR pwzFile,
[in] WER_REGISTER_FILE_TYPE regFileType,
[in] DWORD dwFlags
);
Parametri
[in] pwzFile
Percorso completo del file. La lunghezza massima di questo percorso è MAX_PATH caratteri.
[in] regFileType
Tipo di file. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione WER_REGISTER_FILE_TYPE .
| Valore | Significato |
|---|---|
| WerRegFileTypeMax | |
| 3 | Valore massimo per il tipo di enumerazione WER_REGISTER_FILE_TYPE . |
| WerRegFileTypeOther | |
| 2 | Qualsiasi altro tipo di file. |
| WerRegFileTypeUserDocument | |
| 1 | Documento in uso dall'applicazione al momento dell'evento. Questo documento viene raccolto solo se il server Watson lo richiede. |
[in] dwFlags
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 | Elimina automaticamente il file dopo l'aggiunta al report. |
Valore restituito
Questa funzione restituisce S_OK in caso di esito positivo o un codice di errore in caso di errore, inclusi i codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
| WER_E_INVALID_STATE | Lo stato del processo non è valido. Ad esempio, il processo è in modalità di ripristino dell'applicazione. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | Il numero di blocchi e file di memoria registrati supera il limite. |
Commenti
Il file registrato viene aggiunto al report solo quando vengono richiesti dati aggiuntivi dal server.
Per gli arresti anomali e le non risposte, il sistema operativo fornisce automaticamente la segnalazione degli errori (non è necessario fornire codice di segnalazione errori nell'applicazione). Se si usa questa funzione per registrare un file, il sistema operativo aggiungerà il file al report degli errori creato al momento di un arresto anomalo o di una risposta non (questo file viene aggiunto oltre ai file già raccolti dal sistema operativo).
Per la segnalazione di eventi generici, l'applicazione deve usare invece la funzione WerReportAddFile . In alternativa, chiamando la funzione WerReportSubmit con il flag WER_SUBMIT_ADD_REGISTERED_DATA includerà i file aggiunti dalla funzione WerRegisterFile .
Per rimuovere il file dall'elenco, chiamare la funzione WerUnregisterFile .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | werapi.h |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |