WerAddExcludedApplication function (werapi.h)

Adds the specified application to the list of applications that are to be excluded from Windows Error Reporting (WER).

Syntax

HRESULT WerAddExcludedApplication(
  [in] PCWSTR pwzExeName,
  [in] BOOL   bAllUsers
);

Parameters

[in] pwzExeName

A pointer to a Unicode string that specifies the name of the executable file for the application, including the file name extension. The maximum length of this path is MAX_PATH characters.

[in] bAllUsers

If this parameter is TRUE, the application name is added to the list of excluded applications for all users. Otherwise, it is only added to the list of excluded applications for the current user.

Return value

This function returns S_OK on success or an error code on failure, including the following error code.

Return code Description
E_ACCESSDENIED The process does not have permissions to update the list in the registry. See the Remarks section for additional information.

Remarks

If bAllUsers is TRUE, the list of excluded applications is stored under the HKEY_LOCAL_MACHINE registry hive. The calling process must have permissions to write to the HKLM registry hive.

If bAllUsers is FALSE, the list of excluded applications is stored under the HKEY_CURRENT_USER registry hive.

To remove the application from the list of excluded applications, call the WerRemoveExcludedApplication function.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header werapi.h
Library Wer.lib
DLL Wer.dll

See also

WerRemoveExcludedApplication, Windows Error Reporting