Função VariantToBooleanArrayAlloc (propvarutil.h)
Aloca uma matriz de valores BOOL e extrai dados de uma estrutura VARIANT para essa matriz.
Sintaxe
PSSTDAPI VariantToBooleanArrayAlloc(
[in] REFVARIANT var,
[out] BOOL **pprgf,
[out] ULONG *pcElem
);
Parâmetros
[in] var
Tipo: REFVARIANT
Referência a uma estrutura VARIANT de origem.
[out] pprgf
Tipo: BOOL**
Quando essa função retorna, contém um ponteiro para uma matriz de valores BOOL extraídos da estrutura VARIANT de origem.
[out] pcElem
Tipo: ULONG*
Quando essa função retorna, contém um ponteiro para a contagem de elementos extraídos da estrutura VARIANT de origem.
Retornar valor
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Essa função auxiliar é usada quando o aplicativo de chamada espera que uma VARIANT mantenha uma matriz de valores BOOL .
Se o VARIANT de origem for do tipo VT_ARRAY | VT_BOOL, essa função extrai uma matriz de valores BOOL em uma matriz recém-alocada. O aplicativo de chamada é responsável por usar CoTaskMemFree para liberar a matriz apontada por pprgf quando ela não for mais necessária.
Exemplos
O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar VariantToBooleanArrayAlloc para acessar uma matriz de valores BOOL armazenados em uma estrutura VARIANT .
// 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);
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | propvarutil.h |
| Biblioteca | Propsys.lib |
| DLL | Propsys.dll (versão 6.0 ou posterior) |
| Redistribuível | Pesquisa da Área de Trabalho do Windows (WDS) 3.0 |