Wine API: VarNeg

NAME

VarNeg (OLEAUT32.173)

SYNOPSIS

 HRESULT VarNeg
 (
  LPVARIANT pVarIn,
  LPVARIANT pVarOut
 )

DESCRIPTION

Negate the value of a variant.

PARAMS

`pVarIn`	[In]	Source variant.
`pVarOut`	[Out]	Destination for converted value.

RETURNS

Success: S_OK. pVarOut contains the converted value.

Failure: An HRESULT error code indicating the error.

NOTES

- The type of the value stored in pVarOut depends on the type of pVarIn, according to the following table:

 Input Type       Output Type
 ----------       -----------
  VT_EMPTY         VT_I2
  VT_UI1           VT_I2
  VT_BOOL          VT_I2
  VT_BSTR          VT_R8
  All Others       Unchanged (unless promoted)

- Where the negated value of a variant does not fit in its base type, the type is promoted according to the following table:

 Input Type       Promoted To
 ----------       -----------
   VT_I2            VT_I4
   VT_I4            VT_R8
   VT_I8            VT_R8

- The native version of this function returns DISP_E_BADVARTYPE for valid variant types that cannot be negated, and returns DISP_E_TYPEMISMATCH for types which are not valid. Since this is in contravention of the meaning of those error codes and unlikely to be relied on by applications, this implementation returns errors consistent with the other high level variant math functions.

IMPLEMENTATION

Declared in "oleauto.h". https://source.winehq.org/source/include/oleauto.h

Implemented in "dlls/oleaut32/variant.c". https://source.winehq.org/source/dlls/oleaut32/variant.c

Debug channel "variant".