IESP::Start method
The Start method starts a capture.
Syntax
HRESULT STDMETHODCALLTYPE Start(
[out] char *pFileName
);
Parameters
-
pFileName [out]
-
Pointer to the name of the capture file used to store the network data. Be sure to cache this file name if it is needed for future reference.
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 |
|---|---|
|
The capture is paused and must be stopped before it can be restarted. Call IESP::Stop to stop the capture. |
|
The capture is already started. |
|
The NPP is not connected to the network. Call IESP::Connect to connect the NPP to the network. |
|
The NPP is connected to the network but not with the IESP::Connect method. |
Remarks
The location of the capture file is specified in the Windows registry, but you can use Network Monitor to change the directory location.
When you restart the capture by using the IESP::Start and IESP::Stop methods, you must call the IESP::Configure method to reconfigure the connection each time you call IESP::Start to restart capturing data. When you start and stop the capture with these three methods, a new capture file is created each time the capture is started.
Note
You can also start and stop the capture by using the IESP::Pause and IESP::Resume methods. When these two methods are used, the captured data is stored in the same capture file.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|
| DLL |
|