ListType function (wdbgexts.h)

Article
02/22/2024

The ListType function calls a specified callback function for every element in a linked list.

Syntax

ULONG ListType(
  [in] IN LPCSTR                   Type,
  [in] IN ULONG64                  Address,
  [in] IN USHORT                   ListByFieldAddress,
  [in] IN LPCSTR                   NextPointer,
  [in] IN PVOID                    Context,
  [in] IN PSYM_DUMP_FIELD_CALLBACK CallbackRoutine
);

Parameters

[in] Type

Specifies the name of the type of each entry in the linked list.

[in] Address

If ListByFieldAddress is zero:

Specifies the address in the target's memory of the first entry in the linked list.

If ListByFieldAddress is 1:

Specifies the address in the target's memory of the member of the first entry that points to the next entry.

[in] ListByFieldAddress

Specifies whether Address contains the base address of the first entry, or if it contains the address of the member of the first entry that points to the next entry.

[in] NextPointer

Specifies the name of the member in the structure of type Type that contains a pointer to the next entry in the linked list. NextPointer can be a period-separated path, for example, if Type is "nt!_ETHREAD", NextPointer could be "Tcb.ThreadListEntry.Flink".

[in] Context

Specifies a pointer that is passed to the callback function specified by CallbackRoutine each time the callback function is called.

[in] CallbackRoutine

Specifies a function that is called for each entry in the linked list. The parameters passed to the function are the Context pointer and a FIELD_INFO structure; the address of the entry is found in the address member of this structure.

Return value

This function returns TRUE on success and FALSE on failure.

Requirements

Requirement	Value
Target Platform	Desktop
Header	wdbgexts.h (include Wdbgexts.h, Dbgeng.h)

Share via