Funzione PropVariantToInt64Vector (propvarutil.h)

Estrae i dati da una struttura PROPVARIANT in un vettore Int64 .

Sintassi

PSSTDAPI PropVariantToInt64Vector(
  [in]  REFPROPVARIANT propvar,
  [out] LONGLONG       *prgn,
  [in]  ULONG          crgn,
  [out] ULONG          *pcElem
);

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] prgn

Tipo: LONGLONG*

Punta a un buffer contenente valori LONGLONG crgn. Quando questa funzione restituisce, il buffer è stato inizializzato con elementi PCElemLONGLONG estratti dall'origine PROPVARIANT.

[in] crgn

Tipo: ULONG

Dimensioni del buffer a cui fa riferimento prgn negli elementi.

[out] pcElem

Tipo: ULONG*

Quando questa funzione restituisce, contiene il conteggio dei valori LONGLONG estratti dalla struttura PROPVARIANT di origine.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Commenti

Questa funzione helper viene usata in posizioni in cui l'applicazione chiamante prevede che un PROPVARIANT contenga un vettore di valori LONGLONG con un numero fisso di elementi.

Se l'origine PROPVARIANTha tipo VT_VECTOR VT_I8o | VT_ARRAY | VT_I8, questa funzione helper estrae fino a valori LONGLONGcrgn e li inserisce nel buffer a cui punta da prgn. Se PROPVARIANT contiene più elementi che si adattano al buffer prgn, questa funzione restituisce un errore e imposta pcElem su 0.

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare PropVariantToInt64Vector per accedere a un valore vettore Int64 in un PROPVARIANT.

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
LONGLONG rgLongs[4]; // The application is expecting propvar to hold 4 LONGLONGs in a vector
ULONG cElems;
HRESULT hr = PropVariantToInt64Vector(propvar, rgLongs, ARRAYSIZE(rgLongs), &cElems);
if (SUCCEEDED(hr))
{
     if (cElems == ARRAYSIZE(rgLongs))
     {
         // The application got 4 LONGLONGs which are now stored in rgLongs
     }
     else
     {
         // The application got cElems which are stored in the first cElems elements of rgLongs
     }
}

Requisiti

Vedi anche

InitPropVariantFromInt64Vector

PropVariantGetInt64Elem

PropVariantToInt64

PropVariantToInt64VectorAlloc

VariantToInt64Array