Funzione PropVariantToInt64VectorAlloc (propvarutil.h)

Articolo
03/15/2023

Estrae i dati da una struttura PROPVARIANT in un vettore LONGLONG appena allocato.

Sintassi

PSSTDAPI PropVariantToInt64VectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] LONGLONG       **pprgn,
  [out] ULONG          *pcElem
);

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] pprgn

Tipo: LONGLONG**

Quando questa funzione viene restituita, contiene un puntatore a un vettore di valori LONGLONG estratti dalla struttura PROPVARIANT di origine.

[out] pcElem

Tipo: ULONG*

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

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Restituisce S_OK in caso di esito positivo o un valore di errore in caso contrario.
E_INVALIDARG	PropVARIANT non era del tipo appropriato.

Commenti

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

Se l'origine PROPVARIANT ha tipo VT_VECTOR VT_I8 | oVT_ARRAY VT_I8 | , questa funzione estrae un vettore di valori LONGLONG in un vettore appena allocato. L'applicazione chiamante è responsabile dell'uso di CoTaskMemFree per rilasciare il vettore a cui punta pprgn quando non è più necessario.

Esempio

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

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of LONGLONG values.
LONGLONG *prgLongs;
ULONG cElems;
HRESULT hr = PropVariantToInt64VectorAlloc(propvar, &prgLongs, &cElems);
if (SUCCEEDED(hr))
{
     // prgLongs now points to a vector of cElems LONGLONGs.
     CoTaskMemFree(prgLongs);
}

Requisiti


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