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