Función InitPropVariantFromStringAsVector (propvarutil.h)
Inicializa una estructura PROPVARIANT a partir de una cadena especificada. La cadena se analiza como una lista delimitada por punto y coma (por ejemplo: "A; B; C").
Sintaxis
PSSTDAPI InitPropVariantFromStringAsVector(
[in] PCWSTR psz,
[out] PROPVARIANT *ppropvar
);
Parámetros
[in] psz
Tipo: PCWSTR
Puntero a un búfer que contiene la cadena Unicode de origen.
[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_LPWSTR propvariante. Analiza la cadena de origen como una lista de puntos y coma de valores. Cadena "a; B; c" crea un vector con tres valores. Se quitan los espacios en blanco iniciales y finales y se omiten los valores vacíos.
Si psz es NULL o no contiene ningún valor, la estructura PROPVARIANT se inicializa como VT_EMPTY.
Ejemplos
En el ejemplo siguiente, que se va a incluir como parte de un programa más grande, se muestra cómo usar InitPropVariantFromStringAsVector.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStringAsVector(L"a; b; c", &propvar);
if (SUCCEEDED(hr))
{
// propvar now has type VT_VECTOR | VT_LPWSTR and contains {"a", "b", "c"}.
PropVariantClear(&propvar);
}
Requisitos
| 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 |