Funzione PropVariantToUInt64VectorAlloc (propvarutil.h)

Articolo
03/01/2024

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

Sintassi

PSSTDAPI PropVariantToUInt64VectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] ULONGLONG      **pprgn,
  [out] ULONG          *pcElem
);

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] pprgn

Tipo: ULONGLONG**

Quando questa funzione restituisce, contiene un puntatore a un vettore di valori ULONGLONG estratti dalla struttura PROPVARIANT di origine.

[out] pcElem

Tipo: ULONG*

Quando questa funzione restituisce, contiene il conteggio degli elementi ULONGLONG 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 se ha 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 ULONGLONG .

Se l'origine PROPVARIANT ha tipo VT_VECTOR VT_UI8 | o | VT_ARRAY VT_UI8, questa funzione estrae un vettore di valori ULONGLONG in un vettore appena allocato. L'applicazione chiamante è responsabile dell'uso di CoTaskMemFree per rilasciare il vettore puntato da pprgn quando non è più necessario.

Esempio

L'esempio seguente, da includere come parte di un programma più ampio, illustra come usare PropVariantToUInt64VectorAlloc per accedere a un valore vettore ULONGLONG in un PROPVARIANT.

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

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