IRTC::Configure method
The Configure method submits configuration data for a data capture.
Syntax
HRESULT STDMETHODCALLTYPE Configure(
[in] HBLOB hConfigurationBlob,
[out] HBLOB hErrorBlob
);
Parameters
-
hConfigurationBlob [in]
-
A handle to the BLOB that is configured by the caller.
-
hErrorBlob [out]
-
A handle to an error BLOB that contains additional error data.
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 CreateBlob method has not been called. |
|
The object pointed to is not a BLOB. |
|
The BLOB version number is incorrect. |
|
Duplicate BLOB. |
|
The configuration BLOB specified by hConfigurationBlob lacks an entry needed to perform this operation. View the error BLOB returned by hErrorBlob to determine which entry was not found. |
|
The BLOB Owner or Category data is missing. |
|
The BLOB Owner section was not found. |
|
The BLOB Category section was not found. |
|
The BLOB Category section was found, but not understood. |
|
The BLOB Tag section was found, but not understood. |
|
The BLOB is corrupt. |
|
The trigger portion of the BLOB is corrupt. |
|
The string is not null-terminated. |
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 data that the application can use for troubleshooting. For example, if NMERR_BLOB_ENTRY_DOES_NOT_EXIST is returned, the entry Network Monitor cannot 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 |
|