Compartilhar via

Função PropVariantToVariant (propvarutil.h)

  • Artigo

Converte o conteúdo de uma estrutura PROPVARIANT em uma estrutura VARIANT .

Sintaxe

PSSTDAPI PropVariantToVariant(
  [in]  const PROPVARIANT *pPropVar,
  [out] VARIANT           *pVar
);

Parâmetros

[in] pPropVar

Tipo: const PROPVARIANT*

Ponteiro para uma estrutura PROPVARIANT de origem .

[out] pVar

Tipo: VARIANT*

Ponteiro para uma estrutura VARIANT . Quando essa função retorna, a VARIANT contém as informações convertidas.

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

Normalmente, os dados armazenados no PROPVARIANT são copiados para a VARIANT sem uma alteração de tipo de dados. No entanto, nos casos a seguir, não há suporte direto ao VARIANT para o tipo de dados e eles são convertidos conforme mostrado.

Tipo PROPVARIANT original Armazenado como tipo VARIANT
VT_BLOB, VT_STREAM VT_UNKNOWN. O membro punkVal conterá um ponteiro para um IStream que contém os dados de origem.
VT_LPSTR, VT_LPWSTR, VT_CLSID VT_BSTR
VT_FILETIME VT_DATE
VT_VECTOR|x VT_ARRAY|y
 

Os tipos a seguir não podem ser convertidos com essa função.

  • VT_STORAGE
  • VT_BLOB_OBJECT
  • VT_STREAMED_OBJECT
  • VT_STORED_OBJECT
  • VT_CF
  • VT_VECTOR | VT_CF

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [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