Funzione VariantToBooleanArrayAlloc (propvarutil.h)

Articolo
03/01/2024

Alloca una matrice di valori BOOL e quindi estrae i dati da una struttura VARIANT in tale matrice.

Sintassi

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

Parametri

[in] var

Tipo: REFVARIANT

Riferimento a una struttura VARIANT di origine.

[out] pprgf

Tipo: BOOL**

Quando termina, questa funzione contiene un puntatore a una matrice di valori BOOL estratti dalla struttura VARIANT di origine.

[out] pcElem

Tipo: ULONG*

Quando questa funzione viene restituita, contiene un puntatore al conteggio degli elementi estratti dalla struttura VARIANT di origine.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione helper viene usata quando l'applicazione chiamante prevede che un valore VARIANT contenga una matrice di valori BOOL .

Se l'origine VARIANT è di tipo VT_ARRAY | VT_BOOL, questa funzione estrae una matrice di valori BOOL in una matrice appena allocata. L'applicazione chiamante è responsabile dell'uso di CoTaskMemFree per rilasciare la matrice a cui punta pprgf quando non è più necessaria.

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare VariantToBooleanArrayAlloc per accedere a una matrice di valori BOOL archiviati in una struttura 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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propvarutil.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Vedi anche

InitVariantFromBooleanArray

PropVariantToBooleanVector

VariantToBooleanArray

Condividi tramite