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

Vedere anche

WerUnregisterFile, Segnalazione errori Windows