InitPropVariantFromUInt16Vector-Funktion (propvarutil.h)

Initialisiert eine PROPVARIANT-Struktur basierend auf einem Vektor von 16-Bit-Ganzzahlwerten ohne Vorzeichen.

Syntax

PSSTDAPI InitPropVariantFromUInt16Vector(
  [in]  const USHORT *prgn,
  [in]  ULONG        cElems,
  [out] PROPVARIANT  *ppropvar
);

Parameter

[in] prgn

Typ: const USHORT*

Zeiger auf einen Quellvektor von USHORT-Werten . Wenn dieser Parameter NULL ist, wird propvariant mit Nullen initialisiert.

[in] cElems

Typ: ULONG

Anzahl der Elemente im Vektor, auf den prgn verweist.

[out] ppropvar

Typ: PROPVARIANT*

Wenn diese Funktion zurückgibt, enthält die initialisierte PROPVARIANT-Struktur .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Erstellt eine VT_VECTOR | VT_UI2 Propvariante.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitPropVariantFromUInt16Vector veranschaulicht.

USHORT rgShorts[] = {4, 7};
PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromUInt16Vector(rgShorts, ARRAYSIZE(rgShorts), &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_VECTOR | VT_UI2.
     PropVariantClear(&propvar);
}

Anforderungen

Weitere Informationen

InitPropVariantFromUInt16

InitVariantFromUInt16

PropVariantToUInt16Vector