FilterAddObject
The FilterAddObject function adds a single object to a display filter.
DWORD WINAPIFilterAddObject(HFILTERhFilter,
LPFILTEROBJECTlpFilterObject);
Parameters
- hFilter
[in] Handle to the display filter. - lpFilterObject
[out] Pointer to a FILTEROBJECT structure that defines the object to be added to the filter. Each object can be an operator, value, or property.
Return Values
If the function is successful, the return value is NMERR_SUCCESS.
If the function is unsuccessful, the return value is an error code.
| Return code | Description |
|---|---|
| NMERR_INVALID_PARAMETER | The hFilter parameter has an invalid value. |
| NMERR_OUT_OF_MEMORY | Network Monitor does not have enough memory to create the object. |
Remarks
Experts and parsers can call the FilterAddObject function.
The FilterAddObject function is called each time a filter object is added to the display filter. The display filter is a postfix stack of objects that can be an operator, value, or property.
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. |
| Library | Link to Nmapi.lib. |
| DLL | Requires Nmapi.dll. |