IESP::Stop method

The Stop method stops the current capture.

Syntax

HRESULT STDMETHODCALLTYPE Stop(
  [out] LPSTATISTICS lpStats
);

Parameters

lpStats [out]

Pointer to a STATISTICS structure that contains network statistics such as total frames and total bytes captured.

Return value

If the method is successful, the return value is NMERR_SUCCESS.

If the method is unsuccessful, the return value is one of the following error codes:

Return code Description
NMERR_NOT_CONNECTED
The NPP is not connected to the network. Call IESP::Connect to connect the NPP to the network.
NMERR_NOT_CAPTURING
The NPP is not capturing data. Call IESP::Start to start the capture.
NMERR_NOT_ESP
The NPP is connected to the network but not with the IESP::Connect method.

Remarks

When the IESP::Stop method is called, Network Monitor stops capturing data and closes the capture file. (The name of the capture file was returned when IESP::Start was called.) You can now look at the contents of the capture file.

When you stop and restart the capture, make sure to call the IESP::Configure method each time you call IESP::Start to restart the capture.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

See also

IESP

IESP::Connect

IESP::Start

STATISTICS