Fonction VariantToBooleanArrayAlloc (propvarutil.h)

Alloue un tableau de valeurs BOOL , puis extrait les données d’une structure VARIANT dans ce tableau.

Syntaxe

PSSTDAPI VariantToBooleanArrayAlloc(
  [in]  REFVARIANT var,
  [out] BOOL       **pprgf,
  [out] ULONG      *pcElem
);

Paramètres

[in] var

Type : REFVARIANT

Référence à une structure VARIANT source.

[out] pprgf

Type : BOOL**

Lorsque cette fonction est retournée, contient un pointeur vers un tableau de valeurs BOOL extraites de la structure VARIANT source.

[out] pcElem

Type : ULONG*

Lorsque cette fonction retourne, contient un pointeur vers le nombre d’éléments extraits de la structure VARIANT source.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction d’assistance est utilisée lorsque l’application appelante s’attend à ce qu’un VARIANT contienne un tableau de valeurs BOOL .

Si le VARIANT source est de type VT_ARRAY | VT_BOOL, cette fonction extrait un tableau de valeurs BOOL dans un tableau nouvellement alloué. L’application appelante est responsable de l’utilisation de CoTaskMemFree pour libérer le tableau pointé par pprgf lorsqu’il n’est plus nécessaire.

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus large, montre comment utiliser VariantToBooleanArrayAlloc pour accéder à un tableau de valeurs BOOL stockées dans une structure VARIANT .

// VARIANT var;
// Assume variable var is initialized and valid. 
// The application expects var to contain an array of BOOL values.
BOOL *prgFlags;
ULONG cElems;

HRESULT hr = VariantToBooleanArrayAlloc(var, &prgFlags, &cElems);

if (SUCCEEDED(hr))
{
     // prgFlags now points to a vector of cElems BOOLs.
     CoTaskMemFree(prgFlags);
}

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
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Voir aussi

InitVariantFromBooleanArray

PropVariantToBooleanVector

VariantToBooleanArray