Fonction InitVariantFromDispatch (propvarutil.h)

Article
03/01/2024

Initialise une structure VARIANT en fonction d’une instance d’un objet IDispatch.

Syntaxe

HRESULT InitVariantFromDispatch(
  [in]  IDispatch *pdisp,
  [out] VARIANT   *pvar
);

Paramètres

[in] pdisp

Type : IDispatch*

Pointeur vers l’IDispatch source.

[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_DISPATCH .

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 InitVariantFromDispatch.

// IDispatch *pDispatch;
// Assume variable pDispatch is initialized and valid.
VARIANT var;

HRESULT hr = InitVariantFromDispatch(pDispatch, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_DISPATCH.
    VariantClear(&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

Partager via