POSITION

  • Article

Placeholder for a linked list.

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.

See Also

CBaseList::GetHeadPositionI, CBaseList::GetTailPositionI

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.