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

Vea también

WerUnregisterFile, Informe de errores de Windows