Función InitPropVariantFromBoolean (propvarutil.h)
Inicializa una estructura PROPVARIANT determinada como un VT_BOOL mediante un valor booleano especificado.
Sintaxis
HRESULT InitPropVariantFromBoolean(
[in] BOOL fVal,
[out] PROPVARIANT *ppropvar
);
Parámetros
[in] fVal
Tipo: BOOL
Valor bool de origen.
[out] ppropvar
Tipo: PROPVARIANT*
Cuando se devuelve esta función, contiene la estructura PROPVARIANT inicializada.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Se trata de una función insertada, con su código fuente proporcionado en el encabezado . No se incluye en ningún archivo .dll o .lib.
Tenga en cuenta que el miembro boolVal inicializado específicamente por esta función es de tipo VARIANT_BOOL y, por lo tanto, puede tener valores VARIANT_TRUE o VARIANT_FALSE. Al trabajar directamente con este miembro de estructura, use estas constantes en lugar de TRUE o FALSE porque VARIANT_TRUE no es igual a TRUE y sizeof(VARIANT_TRUE) no es igual que sizeof(TRUE).
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar InitPropVariantFromBoolean.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromBoolean(TRUE, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_BOOL.
PropVariantClear(&propvar);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Redistribuible | Búsqueda de escritorio de Windows (WDS) 3.0 |