InitPropVariantFromString, fonction (propvarutil.h)

Article
03/01/2024

Initialise une structure PROPVARIANT basée sur une chaîne spécifiée.

Syntaxe

HRESULT InitPropVariantFromString(
  [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 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

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 le cadre d’un programme plus large, montre comment utiliser InitPropVariantFromString.

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromString(L"Hello World", &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_LPWSTR.
    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
Composant redistribuable	Windows Desktop Search (WDS) 3.0