Freigeben über


InitVariantFromStringArray-Funktion (propvarutil.h)

Initialisiert eine VARIANT-Struktur mit einem Array von Zeichenfolgen.

Syntax

PSSTDAPI InitVariantFromStringArray(
  [in]  PCWSTR  *prgsz,
  [in]  ULONG   cElems,
  [out] VARIANT *pvar
);

Parameter

[in] prgsz

Typ: PCWSTR*

Zeiger auf ein Array von Zeichenfolgen.

[in] cElems

Typ: ULONG

Die Anzahl der Elemente im Array, auf die prgsz verweist.

[out] pvar

Typ: VARIANT*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

Erstellt eine VT_ARRAY | VT_BSTR Variante.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms enthalten sein soll, wird die Verwendung von InitVariantFromStringArray veranschaulicht.

PCWSTR rgStrings[] = {"dog", "cat"};
VARIANT var;

HRESULT hr = InitVariantFromStringArray(rgStrings, ARRAYSIZE(rgStrings), &var);

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

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
Bibliothek Propsys.lib
DLL Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente Windows Desktop Search (WDS) 3.0

Weitere Informationen

InitPropVariantFromString

InitVariantFromString

VariantToStringArray