Funzione PropVariantToInt16VectorAlloc (propvarutil.h)

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

Sintassi

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

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] pprgn

Tipo: SHORT**

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

[out] pcElem

Tipo: ULONG*

Quando termina, questa funzione contiene il conteggio degli elementi Int16 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 valore di vettore Int16 .

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

Esempio

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

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

Requisiti

Vedi anche

InitPropVariantFromInt16Vector

PropVariantGetInt16Elem

PropVariantToInt16

PropVariantToInt16Vector

VariantToInt16Array