Compartilhar via


Função InitPropVariantVectorFromPropVariant (propvarutil.h)

Inicializa um elemento vetor em uma estrutura PROPVARIANT com um valor armazenado em outro PROPVARIANT.

Sintaxe

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

Parâmetros

[in] propvarSingle

Tipo: REFPROPVARIANT

Referência à estrutura PROPVARIANT de origem que contém um único valor.

[out] ppropvarVector

Tipo: PROPVARIANT*

Quando essa função retorna, contém a estrutura PROPVARIANT inicializada.

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 é usada para converter uma estrutura PROPVARIANT que contém um único valor em um valor de vetor.

Para tipos de origem simples, essa função inicializa o PROPVARIANT como um vetor de um elemento.

Para uma origem que contém uma cadeia de caracteres, essa função inicializa o PROPVARIANT com zero ou mais subcadeias de caracteres retiradas da cadeia de caracteres de origem, tratando ponto-e-vírgula como delimitadores. Consulte InitPropVariantFromStringAsVector para obter mais detalhes.

Os tipos de entrada a seguir são suportados:

  • VT_I2
  • VT_UI2
  • VT_I4
  • VT_UI4
  • VT_I8
  • VT_UI8
  • VT_R8
  • VT_BOOL
  • VT_DATE
  • VT_FILETIME
  • VT_BSTR
  • VT_LPWSTR
Tipos adicionais podem ter suporte no futuro.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar InitPropVariantVectorFromPropVariant.

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       PropVariantClear(&propvar);
    }

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

Confira também

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount