Funzione PropVariantGetFileTimeElem (propvarutil.h)

Articolo
08/25/2023

Estrae un singolo elemento FILETIME da una struttura PROPVARIANT di tipo VT_FILETIME, VT_VECTOR | VT_FILETIME o VT_ARRAY | VT_FILETIME.

Sintassi

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

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Struttura PROPVARIANT di origine.

[in] iElem

Tipo: ULONG

Specifica l'indice vettoriale o matrice; in caso contrario, questo valore deve essere 0.

[out] pftVal

Tipo: FILETIME*

Quando questa funzione viene restituita, contiene il valore filetime estratto.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se l'origine PROPVARIANT ha tipo VT_FILETIME, iElem deve essere 0; in caso contrario, iElem deve essere minore del numero di elementi nel vettore o nella matrice. È possibile usare PropVariantGetElementCount per ottenere il numero di elementi nel vettore o nella matrice.

Esempio

Nell'esempio di codice seguente, da includere come parte di un programma più ampio, viene illustrato come usare PropVariantGetFileTimeElem in un'istruzione di iterazione per accedere ai valori in PROPVARIANT.

// 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
        }
    }
}

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

Vedi anche

PropVariantGetElem

Condividi tramite