Compartilhar via

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

  • Artigo

O método LowHealth permite que a Extensão de Classe Auxiliar marcar se o componente que está sendo diagnosticado está íntegro.

Sintaxe

HRESULT LowHealth(
  [in]  LPCWSTR          pwszInstanceDescription,
  [out] LPWSTR           *ppwszDescription,
  [out] long             *pDeferredTime,
  [out] DIAGNOSIS_STATUS *pStatus
);

Parâmetros

[in] pwszInstanceDescription

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a descrição amigável das informações que estão sendo diagnosticadas. Por exemplo, se uma classe diagnosticasse um problema de conectividade com um endereço IP, o parâmetro pwszInstanceDescription conteria o nome do host.

[out] ppwszDescription

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a descrição do problema encontrado se o componente for considerado não íntegro.

[out] pDeferredTime

Um ponteiro para o tempo, em segundos, a ser adiado se o diagnóstico não puder ser iniciado imediatamente. Isso é usado quando o parâmetro pStatus é definido como DS_DEFERRED.

[out] pStatus

Um ponteiro para o DIAGNOSIS_STATUS retornado do diagnóstico.

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_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

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

Se LowHealth retornar DS_CONFIRMED, ppwszDescription também conterá uma descrição amigável do resultado do diagnóstico. O parâmetro out pDeferredTime contém o número de segundos que esse diagnóstico precisa ser adiado se pStatus retornar DS_DEFERRED.

Quando LowHealth é confirmado, ele também pode, opcionalmente, gerar hipóteses no método GetLowerHypotheses para outras classes auxiliares se o problema puder ser causado por outros componentes. Se não for confirmado, o NDF poderá diagnosticar o problema chamando HighUtilization.

LowHealth também poderá retornar DS_INDETERMINATE se não for possível diagnosticar o problema, mas não puder confirmar se o componente está íntegro. Nesse caso, o NDF o tratará como DS_CONFIRMED se nenhuma das outras hipóteses for confirmada.

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