Compartir a través de

Función InitPropVariantVectorFromPropVariant (propvarutil.h)

  • Artículo

Inicializa un elemento vectorial en una estructura PROPVARIANT con un valor almacenado en otro PROPVARIANT.

Sintaxis

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

Parámetros

[in] propvarSingle

Tipo: REFPROPVARIANT

Referencia a la estructura PROPVARIANT de origen que contiene un único valor.

[out] ppropvarVector

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

Esta función se usa para convertir una estructura PROPVARIANT que contiene un único valor en un valor vectorial.

Para los tipos de origen simples, esta función inicializa el PROPVARIANT como vector de un elemento.

Para un origen que contiene una cadena, esta función inicializa el PROPVARIANT con cero o más subcadenas tomadas de la cadena de origen, tratando los punto y coma como delimitadores. Consulte InitPropVariantFromStringAsVector para obtener más información.

Se admiten los siguientes tipos de entrada:

  • VT_I2
  • VT_UI2
  • VT_I4
  • VT_UI4
  • VT_I8
  • VT_UI8
  • VT_R8
  • VT_BOOL
  • VT_DATE
  • VT_FILETIME
  • VT_BSTR
  • VT_LPWSTR
Es posible que se admita más tipos en el futuro.

Ejemplos

En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo 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 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
Library Propsys.lib
Archivo DLL Propsys.dll (versión 6.0 o posterior)
Redistribuible Búsqueda de escritorio de Windows (WDS) 3.0

Consulte también

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount