Fonction InitVariantFromString (propvarutil.h)

Initialise une structure VARIANT avec une chaîne.

Syntaxe

HRESULT InitVariantFromString(
  [in]  PCWSTR  psz,
  [out] VARIANT *pvar
);

Paramètres

[in] psz

Type : PCWSTR

Pointeur vers une mémoire tampon qui contient la chaîne Unicode source. Si cette valeur est NULL, la fonction initialise le VARIANT avec un BSTRNULL.

[out] pvar

Type : VARIANT*

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

Il s’agit d’une fonction inline, avec son code source fourni dans l’en-tête. Il n’est inclus dans aucun fichier .dll ou .lib.

Exemples

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

VARIANT var;

HRESULT hr = InitVariantFromString(L"This is a test", &var);

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

Configuration requise

Voir aussi

InitPropVariantFromString

InitVariantFromStringArray

VariantToString

VariantToStringWithDefault