Funzione InitPropVariantFromBoolean (propvarutil.h)
Inizializza una determinata struttura PROPVARIANT come VT_BOOL usando un valore booleano specificato.
Sintassi
HRESULT InitPropVariantFromBoolean(
[in] BOOL fVal,
[out] PROPVARIANT *ppropvar
);
Parametri
[in] fVal
Tipo: BOOL
Valore BOOL di origine.
[out] ppropvar
Tipo: PROPVARIANT*
Quando questa funzione restituisce, contiene la struttura PROPVARIANT inizializzata.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Si tratta di una funzione inline, con il relativo codice sorgente fornito nell'intestazione. Non è incluso in alcun file .dll o lib.
Si noti che il membro boolVal inizializzato in modo specifico da questa funzione è di tipo VARIANT_BOOL e pertanto può avere valori VARIANT_TRUE o VARIANT_FALSE. Quando si usa direttamente questo membro della struttura, usare queste costanti anziché TRUE o FALSE perché VARIANT_TRUE non è uguale a TRUE e sizeof(VARIANT_TRUE) non è uguale a sizeof(TRUE).
Esempio
L'esempio seguente, da includere come parte di un programma più ampio, illustra come usare InitPropVariantFromBoolean.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromBoolean(TRUE, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_BOOL.
PropVariantClear(&propvar);
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | propvarutil.h |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |