InitPropVariantVectorFromPropVariant, fonction (propvarutil.h)

Article
03/04/2024

Initialise un élément vectoriel dans une structure PROPVARIANT avec une valeur stockée dans un autre PROPVARIANT.

Syntaxe

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

Paramètres

[in] propvarSingle

Type : REFPROPVARIANT

Référence à la structure PROPVARIANT source qui contient une valeur unique.

[out] ppropvarVector

Type : PROPVARIANT*

Lorsque cette fonction est retournée, contient la structure PROPVARIANT 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

Cette fonction est utilisée pour convertir une structure PROPVARIANT qui contient une valeur unique en valeur vectorielle.

Pour les types sources simples, cette fonction initialise PROPVARIANT en tant que vecteur d’un élément.

Pour une source qui contient une chaîne, cette fonction initialise propVARIANT avec zéro ou plusieurs sous-chaînes extraites de la chaîne source, en traitant les points-virgules comme des délimiteurs. Pour plus d’informations, consultez InitPropVariantFromStringAsVector .

Les types d’entrée suivants sont pris en charge :

VT_I2
VT_UI2
VT_I4
VT_UI4
VT_I8
VT_UI8
VT_R8
VT_BOOL
VT_DATE
VT_FILETIME
VT_BSTR
VT_LPWSTR

D’autres types peuvent être pris en charge à l’avenir.

Exemples

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

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       PropVariantClear(&propvar);
    }

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

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount

Partager via