ListType

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

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

Parameters

Type

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

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.

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.

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".

Context

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

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

Headers: Defined in wdbgexts.h. If you are writing a WdbgExts extension, include wdbgexts.h. If you are writing a DbgEng extension that calls this function, include wdbgexts.h before dbgeng.h (see Writing DbgEng Extension Code for details).