Función InitPropVariantFromUInt32Vector (propvarutil.h)

  • Artículo

Inicializa una estructura PROPVARIANT basada en un vector de valores enteros de 32 bits sin signo.

Sintaxis

PSSTDAPI InitPropVariantFromUInt32Vector(
  [in]  const ULONG *prgn,
  [in]  ULONG       cElems,
  [out] PROPVARIANT *ppropvar
);

Parámetros

[in] prgn

Tipo: const ULONG*

Puntero a un vector de origen de valores de ULONG . Si este parámetro es NULL, el PROPVARIANT se inicializa con ceros.

[in] cElems

Tipo: ULONG

Número de elementos del vector al que apunta prgn.

[out] ppropvar

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

Crea un VT_VECTOR | VT_UI4 propvariante.

Ejemplos

En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar InitPropVariantFromUInt32Vector.

ULONG rgLongs[] = {4, 7};
PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromUInt32Vector(rgLongs, ARRAYSIZE(rgLongs), &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_VECTOR | VT_UI4.
    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

InitPropVariantFromUInt32

InitVariantFromUInt32Array

PropVariantToUInt32Vector