InterlockedDecrement

  LONG InterlockedDecrement(lplVal)    
  LPLONG lplVal; /* address of the variable to decrement */

The InterlockedDecrement function subtracts one from the specified LONG variable.

Parameters

lplVal

Points to the LONG variable to decrement.

Return Value

If the result of the decrement is zero, the return value is zero.

If the result of the decrement is less than zero, the return value is less than zero. If the result of the decrement is greater than zero, the return value is greater than zero. In these cases, the return value may not equal the result of the decrement.

Comments

The variable pointed to by the lplVal parameter must be aligned on a 32-bit boundary. If it is not aligned, this function will fail on multiprocessor x86 systems. It may be in shared or in private memory.