IDelaydC::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 in a paused state and must be stopped before it can be restarted. Call IDelaydC::Stop to stop the capture. For more information, see the Remarks section in this topic. |
|
The capture is already started. |
|
The NPP is not connected to the network. Call IDelaydC::Connect to connect to the network. |
|
The NPP is connected to the network but not with the IDelaydC::Connect method. |
Remarks
The location of the capture file is specified in your Windows registry, but you can use Network Monitor to change the file's location.
To restart the capture by using IDelaydC::Start and IDelaydC::Stop, you must call the IDelaydC::Configure method to reconfigure the connection each time you call the IDelaydC::Start method 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 IDelaydC::Pause and IDelaydC::Resume methods. When you use these two methods, 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 |
|