InitVariantFromBoolean-Funktion (propvarutil.h)

Initialisiert eine VARIANT-Struktur mit einem booleschen Wert.

Syntax

HRESULT InitVariantFromBoolean(
  [in]  BOOL    fVal,
  [out] VARIANT *pvar
);

Parameter

[in] fVal

Typ: BOOL

Quell-BOOL-Wert.

[out] pvar

Typ: VARIANT*

Wenn diese Funktion zurückgibt, enthält die initialisierte VARIANT-Struktur .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Erstellt eine VT_BOOL Variante.

Beachten Sie, dass das boolVal-Strukturmember , das von dieser Funktion initialisiert wird, vom Typ VARIANT_BOOL ist und daher Werte VARIANT_TRUE oder VARIANT_FALSE haben kann. Wenn Sie direkt mit diesem Strukturmember arbeiten, verwenden Sie diese Konstanten anstelle von TRUE oder FALSE , da VARIANT_TRUE nicht gleich TRUE und sizeof(VARIANT_TRUE) nicht mit sizeof(TRUE) identisch ist.

Dies ist eine Inlinefunktion, deren Quellcode im Header bereitgestellt wird. Sie ist in keiner .dll- oder LIB-Datei enthalten.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitVariantFromBoolean veranschaulicht.

VARIANT var;

HRESULT hr = InitVariantFromBoolean(TRUE, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_BOOL.
     VariantClear(&propvar);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propvarutil.h
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Weitere Informationen

InitPropVariantFromBoolean

VariantToBoolean

VariantToBooleanWithDefault