InterlockedExchangePointer

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function atomically exchanges a pair of values. The function prevents more than one thread from using the same variable simultaneously.

If you are exchanging pointer values, this function supersedes InterlockedExchange.

Syntax

PVOID InterlockedExchangePointer(
  PVOID* Target,
  PVOID Value
);

Parameters

• Target
  [in, out] Pointer to the pointer to the value to exchange. The function sets the value to Value.

• Value
  [in] New value for Target.

Return Value

Initial value pointed to by Target.

Remarks

The interlocked functions provide a simple mechanism for synchronizing access to a variable that is shared by multiple threads. The threads of different processes can use this mechanism, if the variable is in shared memory.

Requirements

See Also

Reference

Synchronization Functions
InterlockedExchange