List_Attach

The List_Attach service attaches a list node to the head (front) of a list. A virtual device can attach a node to any list that has a matching node size. This service can be used, for example, to move a node from one list to another.

Parameters

List

Specifies the handle identifying a list. The handle must have been previously created using the List_Create service.

Node

Specifies the address of the node to attach. The node must have been previously created using the List_Allocate service.

Return Value

This service has no return value.

Comments

The service attaches the node to the head of the list. Subsequent calls to the List_Get_First service return the address of this node. The address of the previous head of the list can be retrieved using the List_Get_Next service.

Uses

Flags

See Also

List_Allocate, List_Create, List_Get_First, List_Get_Next, List_Remove, List_Remove_First