Função InitPropVariantFromStringAsVector (propvarutil.h)
Inicializa uma estrutura PROPVARIANT de uma cadeia de caracteres especificada. A cadeia de caracteres é analisada como uma lista delimitada por ponto e vírgula (por exemplo: "A; B; C").
Sintaxe
PSSTDAPI InitPropVariantFromStringAsVector(
[in] PCWSTR psz,
[out] PROPVARIANT *ppropvar
);
Parâmetros
[in] psz
Tipo: PCWSTR
Ponteiro para um buffer que contém a cadeia de caracteres Unicode de origem.
[out] ppropvar
Tipo: PROPVARIANT*
Quando essa função retorna, contém a estrutura PROPVARIANT inicializada.
Valor retornado
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
Cria um VT_VECTOR | VT_LPWSTR propvariante. Ele analisa a cadeia de caracteres de origem como uma lista de ponto e vírgula de valores. A cadeia de caracteres "a; B; c" cria um vetor com três valores. O espaço em branco à esquerda e à direita são removidos e os valores vazios são omitidos.
Se psz for NULL ou não contiver valores, a estrutura PROPVARIANT será inicializada como VT_EMPTY.
Exemplos
O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como 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 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 |