Compartilhar via


Método IESP::Start

O método Start inicia uma captura.

Sintaxe

HRESULT STDMETHODCALLTYPE Start(
  [out] char *pFileName
);

Parâmetros

pFileName [out]

Ponteiro para o nome do arquivo de captura usado para armazenar os dados de rede. Certifique-se de armazenar esse nome de arquivo em cache se ele for necessário para referência futura.

Valor retornado

Se o método for bem-sucedido, o valor retornado será NMERR_SUCCESS.

Se o método não for bem-sucedido, o valor retornado será um dos seguintes códigos de erro:

Código de retorno Descrição
NMERR_CAPTURE_PAUSED
A captura é pausada e deve ser interrompida antes que possa ser reiniciada. Chame IESP::Stop para interromper a captura.
NMERR_CAPTURING
A captura já foi iniciada.
NMERR_NOT_CONNECTED
O NPP não está conectado à rede. Chame IESP::Connect para conectar o NPP à rede.
NMERR_NOT_ESP
O NPP está conectado à rede, mas não com o método IESP::Connect .

Comentários

O local do arquivo de captura é especificado no Registro do Windows, mas você pode usar o Monitor de Rede para alterar o local do diretório.

Ao reiniciar a captura usando os métodos IESP::Start e IESP::Stop , você deve chamar o método IESP::Configure para reconfigurar a conexão sempre que chamar IESP::Start para reiniciar a captura de dados. Quando você inicia e interrompe a captura com esses três métodos, um novo arquivo de captura é criado sempre que a captura é iniciada.

Observação

Você também pode iniciar e parar a captura usando os métodos IESP::P ause e IESP::Resume . Quando esses dois métodos são usados, os dados capturados são armazenados no mesmo arquivo de captura.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Confira também

IESP

IESP::Configure

IESP::Connect

IESP::P ause

IESP::Resume

IESP::Stop