Función WerReportAddFile (werapi.h)

Agrega un archivo al informe de Informe de errores de Windows (WER) especificado.

Sintaxis

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Parámetros

[in] hReportHandle

Identificador del informe. La función WerReportCreate devuelve este identificador.

[in] pwzPath

Puntero a una cadena Unicode que contiene la ruta de acceso completa al archivo que se va a agregar. Esta ruta de acceso puede usar variables de entorno. La longitud máxima de esta ruta de acceso es MAX_PATH caracteres.

[in] repFileType

Tipo de archivo. Este parámetro puede ser uno de los siguientes valores del tipo de enumeración WER_FILE_TYPE .

Valor	Significado
WerFileTypeHeapdump	Minivolcado extendido que contiene datos adicionales, como la memoria del proceso.
WerFileTypeMicrodump	Minivolcado limitado que contiene solo un seguimiento de pila.
WerFileTypeMinidump	Un archivo minivolcado.
WerFileTypeOther	Cualquier otro tipo de archivo. Este archivo siempre se agregará a la cabina (pero solo si el servidor solicita una cabina).
WerFileTypeUserDocument	Documento que usa la aplicación en el momento del evento. El documento solo se agrega si el servidor solicita este tipo de documento.

[in] dwFileFlags

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 podría utilizarse para identificar o ponerse en contacto con el usuario.
WER_FILE_DELETE_WHEN_DONE	Elimine automáticamente el archivo después de enviar el informe.

Valor devuelto

Esta función devuelve S_OK si se ha realizado correctamente o un código de error en caso de error, incluido el código de error siguiente.

Código devuelto	Descripción
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	El archivo especificado no existe.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	El archivo especificado es un documento de usuario y se almacena en un sistema de archivos cifrado; esta combinación no se admite.

Comentarios

Aunque esta función también se puede usar para agregar volcados de memoria (mediante marcas específicas) al informe de errores, la función preferida para agregar volcados de memoria es WerReportAddDump. Solo debe usar esta función si desea recopilar el volcado de memoria y, a continuación, agregarlo al informe.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	werapi.h
Library	Wer.lib
Archivo DLL	Wer.dll

Consulte también

WerReportCreate, Informe de errores de Windows