PropVariantGetFileTimeElem-Funktion (propvarutil.h)

Artikel
03/01/2024

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

Syntax

PSSTDAPI PropVariantGetFileTimeElem(
  [in]  REFPROPVARIANT propvar,
  [in]  ULONG          iElem,
  [out] FILETIME       *pftVal
);

Parameter

[in] propvar

Typ: REFPROPVARIANT

Die PROPVARIANT-Quellstruktur .

[in] iElem

Typ: ULONG

Gibt den Vektor- oder Arrayindex an; Andernfalls muss dieser Wert 0 sein.

[out] pftVal

Typ: FILETIME*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

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

Beispiele

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

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

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

    for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
    {
        FILETIME ftValue;
        hr = PropVariantGetFileTimeElem(propvar, iElem, &ftValue);

        if (SUCCEEDED(hr))
        {
            // ftValue 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