IRTC::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 paused. |
| NMERR_NOT_CAPTURING | The NPP is not capturing data. Call IRTC::Start to start the capture. |
| NMERR_NOT_CONNECTED | The NPP is not connected to the network. Call IRTC::Connect to connect the NPP to the network. |
| NMERR_NOT_REALTIME | The NPP is connected to the network but not with the IRTC::Connect method. |
Remarks
While the capture is in a paused state, new frames are not captured until the IRTC::Resume method is called to restart the capture.
When you use the IRTC::Pause and IRTC::Resume methods to control the capture, Network Monitor continues to add conversation statistics whenever the capture is running.
To restart the capture call IRTC::Resume. To stop the capture, call IRTC::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. |