InitPropVariantFromBooleanVector-Funktion (propvarutil.h)
Initialisiert eine PROPVARIANT-Struktur aus einem angegebenen booleschen Vektor.
Syntax
PSSTDAPI InitPropVariantFromBooleanVector(
[in, optional] const BOOL *prgf,
[in] ULONG cElems,
[out] PROPVARIANT *ppropvar
);
Parameter
[in, optional] prgf
Typ: const BOOL*
Zeiger auf den booleschen Vektor, der zum Initialisieren der Struktur verwendet wird. Wenn dieser Parameter NULL ist, werden die Elemente, auf die vom Strukturelement cabool.pElems verwiesen wird, mit VARIANT_FALSE initialisiert.
[in] cElems
Typ: ULONG
Die Anzahl der Vektorelemente.
[out] ppropvar
Typ: PROPVARIANT*
Wenn diese Funktion zurückgibt, enthält die initialisierte PROPVARIANT-Struktur .
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Dadurch wird ein VT_BOOL | VT_VECTOR Propvariante erstellt.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitPropVariantFromBooleanVector veranschaulicht.
PROPVARIANT propvar;
BOOL rgBool[2] = {TRUE, FALSE};
HRESULT hr = InitPropVariantFromBooleanVector(rgBool, ARRAYSIZE(rgBool), &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_VECTOR | VT_BOOL.
PropVariantClear(&propvar);
}
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 |