InitVariantFromStringArray, fonction (propvarutil.h)

Initialise une structure VARIANT avec un tableau de chaînes.

Syntaxe

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

Paramètres

[in] prgsz

Type : PCWSTR*

Pointeur vers un tableau de chaînes.

[in] cElems

Type : ULONG

Nombre d’éléments dans le tableau pointé par prgsz.

[out] pvar

Type : VARIANT*

Lorsque cette fonction est retournée, contient la structure VARIANT initialisée.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Crée un VT_ARRAY | VT_BSTR variante.

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus large, montre comment utiliser InitVariantFromStringArray.

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);
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propvarutil.h
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Voir aussi

InitPropVariantFromString

InitVariantFromString

VariantToStringArray