Fonction InitPropVariantFromStringAsVector (propvarutil.h)
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 |