Share via

Método INetDiagHelper::GetAttributes (ndhelper.h)

  • Artigo

O método GetAttributes recupera informações adicionais sobre um problema que a extensão de classe auxiliar diagnosticou.

Sintaxe

HRESULT GetAttributes(
  [out] ULONG            *pcelt,
  [out] HELPER_ATTRIBUTE **pprgAttributes
);

Parâmetros

[out] pcelt

Um ponteiro para uma contagem de elementos na matriz HELPER_ATTRIBUTE .

[out] pprgAttributes

Um ponteiro para uma matriz de estruturas HELPER_ATTRIBUTE .

Retornar valor

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_OUTOFMEMORY
 Não há memória suficiente disponível para concluir essa operação.
E_INVALIDARG
 Um ou mais parâmetros não foram fornecidos corretamente.
E_NOTIMPL
 Esse método opcional não é implementado.
E_ACCESSDENIED
 O chamador não tem privilégios suficientes para executar a operação de diagnóstico ou reparo.
E_ABORT
 A operação de diagnóstico ou reparo foi cancelada.
 

As Extensões de Classe Auxiliar podem retornar HRESULTS específicos para as falhas encontradas na função.

Comentários

Esse método não é necessário ao criar uma extensão de classe auxiliar.

Durante o processo de diagnóstico e reparo, uma classe auxiliar pode, opcionalmente, retornar atributos ao NDF que melhoram o tratamento do diagnóstico pelo NDF. Os atributos predefinidos que podem ser retornados ao NDF são os seguintes.

Termo Descrição
werperameter (Tipo: AT_UINT32) Quando o diagnóstico falha, um atributo opcional para o parâmetro de bucket de Relatório de Erros do Windows (WER) específico da classe auxiliar adicional.
werfile (Tipo: AT_STRING) Um atributo opcional para adicionar arquivos específicos da classe auxiliar a relatórios de Relatório de Erros do Windows (WER).
rootcauseid (Tipo: AT_GUID) Classes auxiliares geralmente podem diagnosticar mais de um problema ao mesmo tempo. A análise do problema encontrado poderá ser aprimorada no NDF se a extensão retornar um HelperAttribute do tipo AT_GUID com o parâmetro pszName definido como rootcauseid e o campo Guid definido como um GUID identificando o problema específico encontrado. Esses GUIDs são personalizados definidos pela extensão auxiliar.

Requisitos

Requisito Valor
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 ndhelper.h

Confira também

INetDiagHelper