Funzione VariantToDoubleArrayAlloc (propvarutil.h)

Articolo
03/15/2023

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

Sintassi

PSSTDAPI VariantToDoubleArrayAlloc(
  [in]  REFVARIANT var,
  [out] DOUBLE     **pprgn,
  [out] ULONG      *pcElem
);

Parametri

[in] var

Tipo: REFVARIANT

Riferimento a una struttura VARIANT di origine.

[out] pprgn

Tipo: DOUBLE**

Quando questa funzione viene restituita, contiene un puntatore a una matrice di valori DOUBLE 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 DOUBLE .

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

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare VariantToDoubleArrayAlloc per accedere a un valore di matrice DOUBLE in un valore VARIANT.

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

HRESULT hr = VariantToDoubleArrayAlloc(var, &prgDoubles, &cElems);

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

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

InitVariantFromDoubleArray

PropVariantChangeType

PropVariantToDoubleVectorAlloc

VariantToDoubleArray

Condividi tramite