Compartilhar via


Função WerReportSetParameter (werapi.h)

Define os parâmetros que identificam exclusivamente um evento para o relatório WER (Relatório de Erros do Windows) especificado.

Sintaxe

HRESULT WerReportSetParameter(
  [in]           HREPORT hReportHandle,
  [in]           DWORD   dwparamID,
  [in, optional] PCWSTR  pwzName,
  [in]           PCWSTR  pwzValue
);

Parâmetros

[in] hReportHandle

Um identificador para o relatório. Esse identificador é retornado pela função WerReportCreate .

[in] dwparamID

O identificador do parâmetro a ser definido. Esse parâmetro pode usar um dos valores a seguir.

  • WER_P0
  • WER_P1
  • WER_P2
  • WER_P3
  • WER_P4
  • WER_P5
  • WER_P6
  • WER_P7
  • WER_P8
  • WER_P9

[in, optional] pwzName

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do parâmetro. Se esse parâmetro for NULL, o nome padrão será Px, em que x corresponderá à parte inteira do valor especificado em dwparamID.

[in] pwzValue

O valor do parâmetro.

Retornar valor

Essa função retorna S_OK em caso de êxito ou um código de erro em caso de falha, incluindo o código de erro a seguir.

Código de retorno Descrição
E_HANDLE O identificador especificado não é válido.
WER_E_LENGTH_EXCEEDED O comprimento de um ou mais argumentos de cadeia de caracteres excedeu seu limite.

Comentários

Cada relatório dá suporte aos parâmetros P0 a P9. Essa função define um parâmetro por vez. Se o parâmetro Px estiver definido, todos os parâmetros de P0 e Px deverão ser definidos.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho werapi.h
Biblioteca Wer.lib
DLL Wer.dll

Confira também

WerReportCreate, Relatório de Erros do Windows