InitVariantFromString-Funktion (propvarutil.h)

Initialisiert eine VARIANT-Struktur mit einer Zeichenfolge.

Syntax

HRESULT InitVariantFromString(
  [in]  PCWSTR  psz,
  [out] VARIANT *pvar
);

Parameter

[in] psz

Typ: PCWSTR

Zeiger auf einen Puffer, der die Unicode-Quellzeichenfolge enthält. Wenn dieser Wert NULL ist, initialisiert die Funktion den VARIANT-Wert mit einem NULL-BSTR.

[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_BSTR Variante.

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 InitVariantFromString veranschaulicht.

VARIANT var;

HRESULT hr = InitVariantFromString(L"This is a test", &var);

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

Anforderungen

Weitere Informationen

InitPropVariantFromString

InitVariantFromStringArray

VariantToString

VariantToStringWithDefault