IESP::Pause method

The Pause method pauses the current capture.

Syntax

HRESULT STDMETHODCALLTYPE Pause(
   LPSTATISTICS lpStats
);

Parameters

lpStats

Obsolete.

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_CAPTURE_PAUSED	The capture is already paused.
NMERR_NOT_CAPTURING	The NPP is not capturing data. Call IESP::Start to start the capture.
NMERR_NOT_CONNECTED	The NPP is not connected to the network. Call IESP::Connect to connect the NPP to the network.
NMERR_NOT_ESP	The NPP is connected to the network but not with the IESP::Connect method.

Remarks

While the capture is in a paused state, new data is not added to the current capture file until you call the IESP::Resume method to restart the capture. When Pause and Resume are used to stop and restart the capture, all captured information is put in the same capture file.

When you use the IESP::Pause and IESP::Resume methods to control the capture, Network Monitor continues to add conversation statistics whenever the capture is running.

To restart the capture, call IESP::Resume. To stop the capture, call IESP::Stop.

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::Resume

IESP::Start

IESP::Stop