IDebugControl3::GetSpecificFilterArgument method (dbgeng.h)

The GetSpecificFilterArgument method returns the value of filter argument for the specific filters that have an argument.

Syntax

HRESULT GetSpecificFilterArgument(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ArgumentSize
);

Parameters

[in] Index

Specifies the index of the specific filter whose argument will be returned. Index must be the index of a specific filter that has an argument.

[out, optional] Buffer

Receives the argument for the specific filter. The interpretation of the argument depends on the specific filter.

[in] BufferSize

Specifies the size, in characters, of the buffer that Buffer specifies. This size includes the space for the '\0' terminating character.

[out, optional] ArgumentSize

Receives the size, in characters, of the argument for the specific filter. This size includes the space for the '\0' terminating character.

Return value

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

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

Remarks

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

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

GetSpecificFilterParameters

IDebugControl

IDebugControl2

IDebugControl3

SetSpecificFilterArgument

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