PropVariantToFileTimeVectorAlloc-Funktion (propvarutil.h)
Extrahiert Daten aus einer PROPVARIANT-Struktur in einen neu zugeordneten FILETIME-Vektor.
Syntax
PSSTDAPI PropVariantToFileTimeVectorAlloc(
[in] REFPROPVARIANT propvar,
[out] FILETIME **pprgft,
[out] ULONG *pcElem
);
Parameter
[in] propvar
Typ: REFPROPVARIANT
Verweis auf eine PROPVARIANT-Quellstruktur .
[out] pprgft
Typ: FILETIME**
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf einen Vektor von FILETIME-Werten, die aus der PROPVARIANT-Quellstruktur extrahiert wurden.
[out] pcElem
Typ: ULONG*
Wenn diese Funktion zurückgibt, enthält die Anzahl der FILETIME-Elemente, die aus der PROPVARIANT-Quellstruktur extrahiert wurden.
Rückgabewert
Typ: HRESULT
Gibt einen der folgenden Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. |
|
Propvariant war nicht vom entsprechenden Typ. |
Hinweise
Diese Hilfsfunktion wird an Stellen verwendet, an denen die aufrufende Anwendung erwartet, dass ein PROPVARIANT einen FILETIME-Vektorwert enthält.
Wenn die Quelle PROPVARIANT den Typ VT_VECTOR | VT_FILETIME extrahiert diese Funktion einen Vektor von FILETIMEs-Werten in einen neu zugeordneten Vektor von FILETIME-Werten. Die aufrufende Anwendung ist für die Verwendung von CoTaskMemFree verantwortlich, um den Vektor freizugeben, auf den pprgft verweist, wenn er nicht mehr benötigt wird.
Die FILETIMEs-Ausgabe verwendet dieselbe Zeitzone wie die QUELLDATEITIMEs.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie PropVariantToFileTimeVectorAlloc verwendet wird, um auf einen FILETIME-Vektorwert in einem PROPVARIANT zuzugreifen.
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid.
// The application is expecting propvar to contain a vector of FILETIME values.
BOOL *prgTimes;
ULONG cTimes;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgTimes, &cTimes);
if (SUCCEEDED(hr))
{
// prgTimes now points to a vector of cTimes file times.
CoTaskMemFree(prgTimes);
}
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 |