IDelaydC::Configure method
The Configure method submits configuration information used for a capture.
Syntax
HRESULT STDMETHODCALLTYPE Configure(
[in] HBLOB hConfigurationBlob,
[out] HBLOB hErrorBlob
);
Parameters
-
hConfigurationBlob [in]
-
Handle to the BLOB that contains the configuration information.
-
hErrorBlob [out]
-
Handle to an error BLOB that contains additional error information. For information about the contents of an error BLOB, see the Remarks section in this topic .
Return value
If this 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 NPP reports that the capture session has started. |
|
|
|
|
|
No memory was available. Shut down windows to free up resources. |
|
The configuration BLOB specified by the hConfiguration parameter is not valid. |
Remarks
You must apply this method to restart an NPP that has been started, stopped, but not disconnected.
The error BLOB returned by hErrorBlob contains entries that Network Monitor could not understand or find in the configuration BLOB specified in hConfigurationBlob. The returned error BLOB contains error information that the application can use for troubleshooting. For example, if NMERR_BLOB_ENTRY_DOES_NOT_EXIST is returned, the entry Network Monitor could not find is included in the returned error BLOB.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|
| DLL |
|