Fonction InitPropVariantFromStringAsVector (propvarutil.h)

Article
08/25/2023

Initialise une structure PROPVARIANT à partir d’une chaîne spécifiée. La chaîne est analysée sous la forme d’une liste délimitée par des points-virgules (par exemple : « A ; B; C").

Syntaxe

PSSTDAPI InitPropVariantFromStringAsVector(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

Paramètres

[in] psz

Type : PCWSTR

Pointeur vers une mémoire tampon qui contient la chaîne Unicode source.

[out] ppropvar

Type : PROPVARIANT*

Lorsque cette fonction retourne, 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.

Notes

Crée un VT_VECTOR | VT_LPWSTR propvariant. Il analyse la chaîne source en tant que liste de points-virgules de valeurs. Chaîne « a ; B; c » crée un vecteur avec trois valeurs. Les espaces blancs de début et de fin sont supprimés, et les valeurs vides sont omises.

Si psz a la valeur NULL ou ne contient aucune valeur, la structure PROPVARIANT est initialisée en tant que VT_EMPTY.

Exemples

L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser InitPropVariantFromStringAsVector.

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStringAsVector(L"a; b; c", &propvar);

if (SUCCEEDED(hr))
{
    // propvar now has type VT_VECTOR | VT_LPWSTR and contains {"a", "b", "c"}.
    PropVariantClear(&propvar);
}

Spécifications


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