VariantToDoubleArrayAlloc-Funktion (propvarutil.h)
Ordnet ein Array von DOUBLE-Werten zu und extrahiert dann Daten aus einer VARIANT-Struktur in dieses Array.
Syntax
PSSTDAPI VariantToDoubleArrayAlloc(
[in] REFVARIANT var,
[out] DOUBLE **pprgn,
[out] ULONG *pcElem
);
Parameter
[in] var
Typ: REFVARIANT
Verweis auf eine VARIANT-Quellstruktur .
[out] pprgn
Typ: DOUBLE**
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf ein Array von DOUBLE-Werten , die aus der VARIANT-Quellstruktur extrahiert wurden.
[out] pcElem
Typ: ULONG*
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf die Anzahl der Elemente, die aus der VARIANT-Quellstruktur extrahiert wurden.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Hilfsfunktion wird verwendet, wenn die aufrufende Anwendung erwartet, dass ein VARIANT-Objekt ein Array von DOUBLE-Werten enthält.
Wenn die Quelle VARIANT vom Typ VT_ARRAY | VT_R8 extrahiert diese Funktion ein Array von DOUBLE-Werten in ein neu zugeordnetes Array. Die aufrufende Anwendung ist für die Verwendung von CoTaskMemFree verantwortlich, um das Array freizugeben, auf das pprgn verweist, wenn es nicht mehr benötigt wird.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie VariantToDoubleArrayAlloc verwendet wird, um auf einen DOUBLE-Arraywert in einem VARIANT-Objekt zuzugreifen.
// VARIANT var;
// Assume variable var is initialized and valid.
// The application expects var to contain an array of DOUBLE values.
DOUBLE *prgDoubles;
ULONG cElems;
HRESULT hr = VariantToDoubleArrayAlloc(var, &prgDoubles, &cElems);
if (SUCCEEDED(hr))
{
// prgDoubles now points to a vector of cElems DOUBLEs.
CoTaskMemFree(prgDoubles);
}
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 |