Debugging Tools for Windows

SetSpecificFilterArgument

The SetSpecificFilterArgument and SetSpecificFilterArgumentWide methods set the value of filter argument for the specific filters that can have an argument.

HRESULT
  IDebugControl::SetSpecificFilterArgument(
    IN ULONG  Index,
    IN PCSTR  Argument
    );

HRESULT
  IDebugControl3::SetSpecificFilterArgumentWide(
    IN ULONG  Index,
    IN PCWSTR  Argument
    );

#ifdef UNICODE
#define SetSpecificFilterArgumentT SetSpecificFilterArgumentWide
#else
#define SetSpecificFilterArgumentT SetSpecificFilterArgument
#endif

Parameters

Index
Specifies the index of the specific filter whose argument will be set. Index must be the index of a specific filter that has an argument.
Argument
Specifies the argument for the specific filter. The interpretation of this argument depends on the specific filter.

Return Value

S_OK
The method was successful.
E_INVALIDARG
Index does not refer to a specific filter that has an argument.

This method may also return error values. See Return Values for more details.

Interface Version

SetSpecificFilterArgument is available in all versions of IDebugControl. SetSpecificFilterArgumentWide is available in IDebugControl3 and later versions.

Comments

For a list of specific filters that have argument and the interpretation of those arguments, see Event Filters.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

sx, sxd, sxe, sxi, sxn (Set Exceptions), GetSpecificFilterArgument

Build machine: CAPEBUILD