Funzione PropVariantToUInt32VectorAlloc (propvarutil.h)

Articolo
03/05/2024

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

Sintassi

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

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] pprgn

Tipo: ULONG**

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

[out] pcElem

Tipo: ULONG*

Quando termina, questa funzione contiene il conteggio dei valori ULONG 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 ULONG .

Se l'origine PROPVARIANT ha tipo VT_VECTOR VT_UI4 | o VT_ARRAY VT_UI4 | , questa funzione estrae un vettore di valori ULONG 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 PropVariantToUInt32VectorAlloc per accedere a un valore vettore ULONG in un PROPVARIANT.

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of ULONG values.
ULONG *prgLongs;
ULONG cElems;
HRESULT hr = PropVariantToUInt32VectorAlloc(propvar, &prgLongs, &cElems);
if (SUCCEEDED(hr))
{
     // prgLongs now points to a vector of cElems ULONG.
     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