Función WerRegisterFile (werapi.h)
Registra un archivo que se va a recopilar cuando Informe de errores de Windows (WER) crea un informe de errores.
Sintaxis
HRESULT WerRegisterFile(
[in] PCWSTR pwzFile,
[in] WER_REGISTER_FILE_TYPE regFileType,
[in] DWORD dwFlags
);
Parámetros
[in] pwzFile
Ruta de acceso completa al archivo. La longitud máxima de esta ruta de acceso es MAX_PATH caracteres.
[in] regFileType
Tipo de archivo. Este parámetro puede ser uno de los siguientes valores del tipo de enumeración WER_REGISTER_FILE_TYPE .
Valor | Significado |
---|---|
WerRegFileTypeMax | |
3 | Valor máximo del tipo de enumeración WER_REGISTER_FILE_TYPE . |
WerRegFileTypeOther | |
2 | Cualquier otro tipo de archivo. |
WerRegFileTypeUserDocument | |
1 | Documento en uso por la aplicación en el momento del evento. Este documento solo se recopila si el servidor Watson lo solicita. |
[in] dwFlags
Este parámetro puede ser uno o más de los siguientes valores.
Valor | Significado |
---|---|
WER_FILE_ANONYMOUS_DATA | El archivo no contiene información personal que pueda utilizarse para identificar o ponerse en contacto con el usuario. |
WER_FILE_DELETE_WHEN_DONE | Elimina automáticamente el archivo después de agregarlo al informe. |
Valor devuelto
Esta función devuelve S_OK si se ejecuta correctamente o un código de error en caso de error, incluidos los siguientes códigos de error.
Código devuelto | Descripción |
---|---|
WER_E_INVALID_STATE | El estado del proceso no es válido. Por ejemplo, el proceso está en modo de recuperación de aplicaciones. |
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | El número de bloques y archivos de memoria registrados supera el límite. |
Comentarios
El archivo registrado se agrega al informe solo cuando el servidor solicita datos adicionales.
En el caso de bloqueos y no respuestas, el sistema operativo proporciona automáticamente informes de errores (no es necesario proporcionar ningún código de informe de errores en la aplicación). Si usa esta función para registrar un archivo, el sistema operativo agregará el archivo al informe de errores creado en el momento de un bloqueo o no respuesta (este archivo se agrega además de los archivos que el sistema operativo ya recopila).
En el caso de los informes de eventos genéricos, la aplicación debe usar la función WerReportAddFile en su lugar. Como alternativa, al llamar a la función WerReportSubmit con la marca WER_SUBMIT_ADD_REGISTERED_DATA se incluirán los archivos que agregó la función WerRegisterFile .
Para quitar el archivo de la lista, llame a la función WerUnregisterFile .
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista [aplicaciones de escritorio | aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | werapi.h |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |