.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH VarNeg 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBVarNeg\fR (OLEAUT32.173)
.SH SYNOPSIS
HRESULT VarNeg
 (
  LPVARIANT \fIpVarIn\fR,
  LPVARIANT \fIpVarOut\fR
 )

.SH DESCRIPTION
.PP
Negate the value of a variant. 

.SH PARAMS
\fIpVarIn\fR \fB[In]\fR  Source variant.
.PP
\fIpVarOut\fR \fB[Out]\fR  Destination for converted value.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. \fIpVarOut\fR contains the converted value. 
.PP
\fBFailure:\fR An \fBHRESULT\fR error code indicating the error. 

.SH NOTES
.PP
\fB-\fR The type of the value stored in \fIpVarOut\fR depends on the type of \fIpVarIn\fR, according to the following table: 
.br
 Input Type       Output Type
.br
 ----------       -----------
.br
  VT_EMPTY         VT_I2
.br
  VT_UI1           VT_I2
.br
  VT_BOOL          VT_I2
.br
  VT_BSTR          VT_R8
.br
  All Others       Unchanged (unless promoted)
.PP
\fB-\fR Where the negated value of a variant does not fit in its base type, the type is promoted according to the following table: 
.br
 Input Type       Promoted To
.br
 ----------       -----------
.br
   VT_I2            VT_I4
.br
   VT_I4            VT_R8
.br
   VT_I8            VT_R8
.PP
\fB-\fR The native version of this function returns \fBDISP_E_BADVARTYPE\fR for valid variant types that cannot be negated, and returns \fBDISP_E_TYPEMISMATCH\fR 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. 

.SH IMPLEMENTATION
.PP
Declared in \fB"oleauto.h"\fR. 
.PP
Implemented in \fB"dlls/oleaut32/variant.c"\fR. 
.PP
Debug channel \fB"variant"\fR.