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 |