IDebugSymbols3::GetSymbolEntriesByName method (dbgeng.h)

The GetSymbolEntriesByName method returns the symbols whose names match a given pattern.

Syntax

HRESULT GetSymbolEntriesByName(
  [in]            PCSTR                Symbol,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Ids,
  [in]            ULONG                IdsCount,
  [out, optional] PULONG               Entries
);

Parameters

[in] Symbol

Specifies the pattern used to determine which symbols to return. This method returns the symbols whose name matches the string wildcard syntax pattern Symbol.

[in] Flags

Set to zero.

[out, optional] Ids

Receives the symbols. This is an array of IdsCount entries of type DEBUG_MODULE_AND_ID. If Ids is NULL, this information is not returned.

[in] IdsCount

Specifies the number of entries that the array Ids can hold.

[out, optional] Entries

Receives the number of symbols whose names match the pattern Symbol. If entries is NULL, this information is not returned.

Return value

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

Return code Description
S_OK
The method was successful.

Remarks

For more information about symbols, see Symbols.

Requirements

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

See also

GetSymbolEntriesByOffset

IDebugSymbols3