PropVariantToBooleanVectorAlloc-Funktion (propvarutil.h)
Extrahiert Daten aus einer PROPVARIANT-Struktur in einen neu zugeordneten booleschen Vektor.
Syntax
PSSTDAPI PropVariantToBooleanVectorAlloc(
[in] REFPROPVARIANT propvar,
[out] BOOL **pprgf,
[out] ULONG *pcElem
);
Parameter
[in] propvar
Typ: REFPROPVARIANT
Verweis auf eine PROPVARIANT-Quellstruktur .
[out] pprgf
Typ: BOOL**
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf einen Vektor boolescher Werte, die aus der PROPVARIANT-Quellstruktur extrahiert wurden.
[out] pcElem
Typ: ULONG*
Wenn diese Funktion zurückgibt, enthält die Anzahl der booleschen Elemente, die aus der PROPVARIANT-Quellstruktur extrahiert wurden.
Rückgabewert
Typ: HRESULT
Diese Funktion kann einen dieser Werte zurückgeben.
| 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 eine PROPVARIANT einen booleschen Vektorwert enthält.
Wenn die Quelle PROPVARIANT den Typ VT_VECTOR | VT_BOOL oder VT_ARRAY | VT_BOOL extrahiert diese Funktion einen Vektor boolescher Werte in einen neu zugeordneten Vektor von BOOL-Werten . Die aufrufende Anwendung ist für die Verwendung von CoTaskMemFree verantwortlich, um den Vektor freizugeben, auf den pprgf verweist, wenn er nicht mehr benötigt wird.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie PropVariantToBooleanVectorAlloc verwendet wird, um auf einen booleschen 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 Boolean values.
BOOL *prgFlags;
ULONG cFlags;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgFlags, &cFlags);
if (SUCCEEDED(hr))
{
// The prgFlags variable now points to a vector that contains a count
// of cFlags flags.
CoTaskMemFree(prgFlags);
}
Anforderungen
| 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 |