PropVariantGetInt64Elem-Funktion (propvarutil.h)

Artikel
03/01/2024

Extrahiert ein einzelnes Int64-Element aus einer PROPVARIANT-Struktur vom Typ VT_I8, VT_VECTOR | VT_I8 oder VT_ARRAY | VT_I8.

Syntax

PSSTDAPI PropVariantGetInt64Elem(
  [in]  REFPROPVARIANT propvar,
  [in]  ULONG          iElem,
  [out] LONGLONG       *pnVal
);

Parameter

[in] propvar

Typ: REFPROPVARIANT

Verweis auf die Quellstruktur PROPVARIANT .

[in] iElem

Typ: ULONG

Der Vektor- oder Arrayindex; Andernfalls muss iElem 0 sein.

[out] pnVal

Typ: LONGLONG*

Wenn diese Funktion zurückgibt, enthält den extrahierten Int64-Wert.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Hilfsfunktion funktioniert fürPROPVARIANT-Strukturen der folgenden Typen:

VT_I8
VT_VECTOR | VT_I8
VT_ARRAY | VT_I8

Wenn die Propvariant-Quelle den Typ VT_I8 hat, muss iElem 0 sein. Andernfalls muss iElem kleiner als die Anzahl der Elemente im Vektor oder Array sein. Sie können PropVariantGetElementCount verwenden, um die Anzahl der Elemente im Vektor oder Array abzurufen.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie PropVariantGetInt64Elem mit einer Iterationsanweisung verwendet wird, um auf die Werte in einer PROPVARIANT-Instanz zuzugreifen.

// PROPVARIANT propvar;
// Assume propvar is initialized and valid;

if ((propvar.vt & VT_TYPEMASK) == VT_I8)
{
    UINT cElem = PropVariantGetElementCount(propvar);
    HRESULT hr = <mark type="const">S_OK</mark>;

    for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
    {
        LONGLONG nValue;
        hr = PropVariantGetInt64Elem(propvar, iElem, &nValue);

        if (SUCCEEDED(hr))
        {
            // nValue is valid now
        }
    }
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propvarutil.h
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Weitere Informationen

PropVariantGetElem

Freigeben über