IDelaydC::Pause

The Pause method pauses the current capture.

HRESULT STDMETHODCALLTYPE Pause();

Parameters

This method has no parameters.

Return Values

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 in a paused state.
NMERR_NOT_CAPTURING	The NPP is not capturing data. Call IDelaydC::Start to start the capture.
NMERR_NOT_CONNECTED	The NPP is not connected to the network. Call IDelaydC::Connect to connect the NPP to the network.
NMERR_NOT_DELAYED	The NPP is connected to the network but not with the IDelaydC::Connect method.

Remarks

While the capture is in a paused state, new data is not added to the current capture file until the IDelaydC::Resume method is called 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 using IDelaydC::Pause and IDelaydC::Resume to control the capture, Network Monitor continues to add conversation statistics whenever the capture is running.

To restart the capture, call IDelaydC::Resume.

To stop the capture, call IDelaydC::Stop.

Requirements

Client	Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server	Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header	Declared in Netmon.h.
DLL	Requires Ndisnpp.dll. Requires Rmtnpp.dll.

See Also

IDelaydC::Connect, IDelaydC::Resume, IDelaydC::Start, IDelaydC::Stop