Función VariantToBooleanArrayAlloc (propvarutil.h)
Asigna una matriz de valores BOOL y extrae los datos de una estructura VARIANT en esa matriz.
Sintaxis
PSSTDAPI VariantToBooleanArrayAlloc(
[in] REFVARIANT var,
[out] BOOL **pprgf,
[out] ULONG *pcElem
);
Parámetros
[in] var
Tipo: REFVARIANT
Referencia a una estructura VARIANT de origen.
[out] pprgf
Tipo: BOOL**
Cuando se devuelve esta función, contiene un puntero a una matriz de valores BOOL extraídos de la estructura VARIANT de origen.
[out] pcElem
Tipo: ULONG*
Cuando esta función vuelve, contiene un puntero al recuento de elementos extraídos de la estructura VARIANT de origen.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Esta función auxiliar se usa cuando la aplicación que realiza la llamada espera que variant contenga una matriz de valores BOOL .
Si el valor VARIANT de origen es de tipo VT_ARRAY | VT_BOOL, esta función extrae una matriz de valores BOOL en una matriz recién asignada. La aplicación que realiza la llamada es responsable de usar CoTaskMemFree para liberar la matriz a la que apunta pprgf cuando ya no es necesaria.
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar VariantToBooleanArrayAlloc para tener acceso a una matriz de valores BOOL almacenados en una estructura 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);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Windows Desktop Search (WDS) 3.0 |