POSITION Structure

Placeholder for a linked list.

Syntax

struct __POSITION { int unused; };
typedef __POSITION* POSITION;

Members

unused
Integer value that specifies the location of an item in a linked list.

Remarks

This structure can point to any element in a linked list, including null elements (such as an end-of-list marker). This structure will, however, become invalid if you delete the item it points to.
When you perform operations that return a POSITION pointer on a single list element, a successful operation sets it to an appropriate non-null value, while NULL indicates that the items position could not be found. When you perform operations on the entire list, the pointer represents a Win32 BOOLEAN value, where TRUE indicates success and FALSE indicates failure.