Função NdfGetTraceFile (ndfapi.h)

A função NdfGetTraceFile é usada para recuperar o caminho que contém um arquivo ETL (Log de Rastreamento de Eventos) que contém eventos ETW (Rastreamento de Eventos para Windows) de uma sessão de diagnóstico.

Sintaxe

void NdfGetTraceFile(
  [in]  NDFHANDLE Handle,
  [out] LPCWSTR   *TraceFileLocation
);

Parâmetros

[in] Handle

Tipo: NDFHANDLE

Manipule para um incidente da Estrutura de Diagnóstico de Rede. Esse identificador deve corresponder ao identificador de um incidente existente.

[out] TraceFileLocation

Tipo: LPCWSTR*

O local do arquivo de rastreamento.

Retornar valor

Tipo: HRESULT

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
S_OK	A operação foi realizada com êxito.

 

Qualquer resultado diferente de S_OK deve ser interpretado como um erro.

Comentários

Essa função não pode ser chamada em um incidente que já foi fechado.

Os arquivos ETL contêm informações como quais componentes foram diagnosticados, informações de configuração de componente e resultados de diagnóstico. Para obter mais informações sobre arquivos ETL, consulte Rastreamento de rede no Windows 7.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ndfapi.h
Biblioteca	Ndfapi.lib
DLL	Ndfapi.dll