Compartilhar via

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

  • Artigo

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