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

O método GetLifeTime recupera o tempo de vida da instância da Extensão de Classe Auxiliar.

Sintaxe

HRESULT GetLifeTime(
  [out] LIFE_TIME *pLifeTime
);

Parâmetros

[out] pLifeTime

Um ponteiro para uma estrutura LIFE_TIME .

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.

Os dados de tempo de vida são usados para limitar o escopo de tempo de uma instância de problema. Isso é particularmente útil ao fazer diagnósticos baseados em histórico, como rastreamento e registro em log, em que ele pode ser usado no escopo do diagnóstico para eventos ocorridos durante o intervalo de tempo especificado.

Por exemplo, as classes auxiliares da Plataforma de Filtragem do Windows (WFP) usam o tempo de vida para determinar qual filtro bloqueou um pacote verificando o log de rastreamento. Por padrão, um tempo de vida de uma instância de classe auxiliar herda o tempo de vida de sua instância de classe auxiliar dependente.

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