Função PropVariantToInt64VectorAlloc (propvarutil.h)
Extrai dados de uma estrutura PROPVARIANT em um vetor LONGLONG recém-alocado.
Sintaxe
PSSTDAPI PropVariantToInt64VectorAlloc(
[in] REFPROPVARIANT propvar,
[out] LONGLONG **pprgn,
[out] ULONG *pcElem
);
Parâmetros
[in] propvar
Tipo: REFPROPVARIANT
Referência a uma estrutura PROPVARIANT de origem .
[out] pprgn
Tipo: LONGLONG**
Quando essa função retorna, contém um ponteiro para um vetor de valores LONGLONG extraídos da estrutura PROPVARIANT de origem.
[out] pcElem
Tipo: ULONG*
Quando essa função retorna, contém a contagem de valores LONGLONG extraídos da estrutura PROPVARIANT de origem .
Valor retornado
Tipo: HRESULT
Essa função pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Retorna S_OK se tiver êxito ou um valor de erro caso contrário. |
|
OPROPVARIANT não era do tipo apropriado. |
Comentários
Essa função auxiliar é usada em locais em que o aplicativo de chamada espera que um PROPVARIANT mantenha um vetor de valores LONGLONG .
Se o PROPVARIANT de origem tiver o tipo VT_VECTOR | VT_I8 ou VT_ARRAY | VT_I8, essa função extrairá um vetor de valores LONGLONG em um vetor recém-alocado. O aplicativo de chamada é responsável por usar CoTaskMemFree para liberar o vetor apontado por pprgn quando ele não é mais necessário.
Exemplos
O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar PropVariantToInt64VectorAlloc para acessar um valor de vetor LONGLONG em um PROPVARIANT.
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of LONGLONG values.
LONGLONG *prgLongs;
ULONG cElems;
HRESULT hr = PropVariantToInt64VectorAlloc(propvar, &prgLongs, &cElems);
if (SUCCEEDED(hr))
{
// prgLongs now points to a vector of cElems LONGLONGs.
CoTaskMemFree(prgLongs);
}
Requisitos
| 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 |