EndSymbolMatch

The EndSymbolMatch method releases the resources used by a symbol search.

HRESULT
  IDebugSymbols::EndSymbolMatch(
        IN ULONG64  Handle
    );

Parameters

Handle

Specifies the handle returned by StartSymbolMatch when the search was initialized.

Return Value

S_OK

The method was successful.

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

Interface Version

EndSymbolMatch is available in all versions of IDebugSymbols.

Comments

This method releases the resources held by the engine during a symbol search. After these resources are released, the handle becomes invalid, so it must not be passed to GetNextSymbolMatch after it has been passed to this method.

For more information about symbols, see Symbols.

Requirements

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

See Also

GetNextSymbolMatch, StartSymbolMatch